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PREFACE 


In this manual you will find all the commands and Statements used by ATARI® 
Microsoft BASIC. The INSTRUCTION list on the inside front cover is in alphabetical 
Order with page numbers for your convenience. 

BASIC was developed at Dartmouth College by John Kemeny and Thomas Kurtz. It 
was designed to be an easy Computer language to learn and use. Many additions in re- 
centyears have made BASIC a complete and useful language for skilled programmers. 

This reference manual does not teach BASIC. Those who wish to learn BASIC should 
read an introductory book. Helpful books are: Computer Programming in BASIC for 
Everyone by Dwyer and Kaufman, and Basic BASIC by James S. Coan. 
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LOADING INSTRUCTIONS 


Important: The disk-based release of ATARI® Microsoft BASIC requires that all Car¬ 
tridges (ATARI BASIC, Assembler Editor, games, and the like) be removed from the 
front cartridge slots of your Computer. You will need a blank diskette in addition to the 
ATARI Microsoft BASIC diskette on which to störe programs. 

Warning: The ATARI Microsoft BASIC diskette is write-protected. Do not attempt to 
punch a notch in the corner in order to write on it. Attempting to make a read/write 
diskette out of your ATARI Microsoft BASIC diskette could destroy BASIC and void all 
warranties. 

Use the following setup procedure to load ATARI Microsoft BASIC, format a blank 
diskette, write DOS files, create MEM.SAV, and transfer CIOUSR and DIR files (see 
Quick-Reference Guide for a list of timesaving Steps). 

1. Connect the ATARI 800 Home Computer to a television set and to a wall 
outlet as instructed in the operators manual. 

Note: ATARI Microsoft BASIC requires a minimum of 32K of RAM. 

2. Connect the ATARI 810™ Disk Drive to the ATARI 800 Home Computer and 
to a wall outlet as instructed in th e ATARI 810 Disk Drive Operators Manual. 

3. Turn on your television set. 

4. Turn the POWER (PWR) switch to ON for Disk Drive 1. Disk drive numbers are 
set by switches located in the back of your disk drive. Consult your ATARI 810 
Disk Drive Operators Manual for drive numbers. Turn the POWER (PWR) 
switch to ON for any other disk drives you wish to use. Two red lights (the 
BUSY light and the PWR ON light) will come on. 

5. When the BUSY light goes out on Disk Drive 1, open the drive door by press- 
ing the door handle release lever. 

6. Hold the ATARI Microsoft BASIC diskette with the label in the lower right cor¬ 
ner and the arrow pointing towards the disk drive. Insert the diskette into the 
disk drive and close the disk drive door. 

7. Switch the Computer console POWER (PWR) to ON. ATARI Microsoft BASIC 
will load into the Computers memory automatically. 

8. Type DOS IgffiüfSl . The Disk Operating System II Version 2.0S will load into 
your Computers memory. 

9. Remove your ATARI Microsoft BASIC Diskette from the disk drive and insert 
a blank diskette (CX8202). 

10. Use the I DOS Option to format the blank diskette. 

11. Use the H DOS Option to write DOS files onto the diskette. 
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12. Use the N DOS Option to create MEM.SAVE. The MEM.SAV file is used to 
save the ATARI Microsoft BASIC program in memory when you use the DOS 
command. See the ATARI Disk Operating System II Reference Manual for 
more Information on MEM.SAVE. 

13. If you have two disk drives you can use the C DOS Option to copy files from 
the ATARI Microsoft BASIC diskette. If you have one disk drive you must use 
the O DOS Option. 

Copying files with two disk drives: 


• Put ATARI Microsoft BASIC in Drive 2. 

• Put formatted diskette in Drive 1. 


• Type C 32111S 

• Respond to COPY—FROM, TO? by typing D2:*.*,D1:*.* 


• Turn off the Computer and reload ATARI Microsoft BASIC. MEM.SAV is 
now at work. 


Copying files with one disk drive: 


• Put ATARI Microsoft BASIC in disk drive. 

• Type O ?JTi 

• Respond to NAME OF FILE TO MOVE? 

• Press fLSfgp since source disk is in place. 

• Insert blank as DESTINATION DISK and press ffJTjJg. 

• Repeat the O procedure with the file DIR. 

• Turn off Computer and reload. ATARI Microsoft BASIC. MEM.SAV is 
now at work. 


14. Remove your newly created program storage diskette and insert the ATARI 
Microsoft BASIC diskette. Turn your Computer console off and then back on 
again to reload and reinitialize BASIC. To activate the MEM.SAV file you 
must remove BASIC and insert a program storage diskette. Put your program 
storage diskette back into the disk drive and press Bf SfSTB-fg lt. By pressing 
E« with your program storage diskette in the disk drive, the 
MEM.SAV diskette file will save the correct return locations for future returns 
to BASIC. 

15. If you wish to have duplicate program storage diskettes, now is the time to 
make them since you have not yet stored any programs. Use DOS Option I to 
format the duplicate storage diskette. Then use the H Option to write DOS 
files. Now use the J Option to duplicate the program storage diskette. 

You should now remove the ATARI Microsoft BASIC diskette and hereafter use the 
new program storage diskettefs) you have created. With a program diskette you can 
save and load the programs you write, and return to BASIC. 

Pressing with a program storage diskette in the disk drive brings you back 

to BASIC with a "Warmstart," which means that the variables and your program will be 
just as you left it before you typed DOS BUS . 
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QUICK-REFERENCE GUIDE 

1. Boot* System with ATARI Microsoft BASIC Master Diskette. 

2. Type DOS MH1 

3. Remove BASIC Master Diskette. 

4. Format blank diskette. (DOS 2.OS) 

5. Write DOS files to the new diskette. 

6. Create MEM.SAV on the diskette. 

7. Copy from BASIC Master Diskette to your new diskette, CIOUSR and 
DIR. 

8. Turn off your System and reboot* with ATARI Microsoft BASIC. 

9. Insert newly created diskette into Drive 1. 

10. Type DOS 

11. After DUP file is loaded, press 

12. Use your newly created program storage diskette to make duplicate 
program storage diskettes (DOS Option J). 

Note: Steps 10,11, and 12 write the correct Microsoft memory images into 
the MEM.SAV files on your Microsoft BASIC program storage diskette. 

*BASIC loads into RAM automatically (boots) when you turn on the Com¬ 
puter. 
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MICROSOFT OVERVIEW 


ATARI® Microsoft BASIC is a customized and enhanced BASIC programming 
language. It was developed by Microsoft for the ATARI 800™ Home Computer, which 
uses the 6502 microprocessor and customized graphics and sound-integrated circuits. 

In the development of ATARI Microsoft BASIC, the two primary considerations were 
Processing speed and compatibility with other microcomputer BASIC languages. The 
fast ATARI 800 Computer clock rate of 1.8 MHz combines with the state-of-the-art 
Microsoft design to give high microprocessor throughput speed. ATARI Microsoft 
BASIC is a superset of the existing microcomputer languages. That is, ATARI Microsoft 
BASIC combines the capabilities of other microcomputer BASIC languages with some 
unique features. New graphics features have been added to take advantage of the 
hardware-supported player-missile graphics. Sound capabilities now include the ability 
to set the length of time a sound is heard. You can renumber and merge programs easi- 
ly with Microsoft BASIC. This is a powerful language with Software tools to fit a variety 
of needs. 


WHAT IS A 
PROGRAM? 


Line numbers always precede Statements that you want stored in memory. Because the 
Statements that have line numbers wait in memory until the command RUN is given, 
they are written in what is called the deferred mode. 

To be exact, execution of a program waits until you type the word RUN and press the 
||§Jg|J§ key. When ATARI Microsoft BASIC is first loaded, it is ready for you to write 
programs (deferred mode) or execute Statements immediately (direct mode). 

When the Computer is ready to accept input, a prompt >appears on your television 
screen. When you see the >, you can enter Statements with line numbers (deferred 
mode) or Statements without line numbers for immediate execution. 

Let's write a BASIC program in the deferred mode: 

> 

100 PRINT 7 * 7 

run miia 

49 


A program is a list of Steps (statements) that you wish the Computer to perform. Every 
Statement stored in memory must have a line number. The lowest line number is 0 and 
the highest allowable line number is 63999. Statements are performed in line number 
order starting with the lowest numbered line. You can change the order in which the 
statements are performed by branching or jumping to other line numbers. 


This single-line program does not execute immediately. The program waits to perform 
the Statement until you type RUN and press JU§j^gj|. The word RUN typed without a 
line number, executes the program immediately after you press the JjJjjjgJjjjjH key. 
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KEYWORDS Keywords must be spelled out. Abbreviations are not legal syntax in ATARI Microsoft 

BASIC. 

Keywords are words the Computer recognizes. Each keyword teils the Computer what 

you want done. The words IF, COSUB, INPUT, and COTO are keywords. Keywords 

can be thought of as the verbs in the vocabulary of your Computer. If you write a State¬ 
ment that uses a keyword the Computer does not recognize, BASIC will give you an 
ERROR Statement when you run the program. ATARI Microsoft BASIC does not allow 
you to use keywords as variables, but does allow you to embed keywords in the 
variable names. That is, IF and COSUB cannot be variables, but LIFE and RCOSUB are 
allowed. A complete list of keywords is given in Appendix L. 


LINE 

CONSTRUCTION 


100IFAOB THEN 630 ELSE 210 

Just as there are punctuation marks in the English language, so there are quotes, com- 
mas, semicolons, and colons in BASIC. The rules of punctuation are listed in this 
manual with the keywords that require them or have them as options. Following is a 
summary of punctuation use. 

QUOTATION MARKS 

The quotation marks are used to indicate where typed characters begin and end. Just 
as we use quotes in English to mark the beginning and end of a speakebs words, so it is 
with BASIC. The quote mark means that the material quoted constitutes a String 
variable or String constant; Strings will be covered later in the text. For now it is enough 
to know that quotes teil the Computer where to begin and end a String. The String in 
this example program will be told when to Start and stop printing on the screen by 
quotes: 

Example Program: 

100 PRINT "START PRINTING ON SCREEN-NOW STOP" 

run lamsji 

START PRINTING ON SCREEN-NOW STOP 


THE COMMA 

The comma has three uses. 

• Use the comma to separate required items after a keyword. The keyword 
SOUND has five different functions in ATARI Microsoft BASIC. Each parameter 
is separated by commas. For example, SOUND 2,&79,10,8,60 means voice 2, 
pitch hexadecimal 79 (middle C), noise 10, volume 8, and duration in jiffies (1/60 
of a second) 60. Another example of the comma is the Statement SETCOLOR 
4,4,10 which means register 4, pink, bright luminance. The comma teils where 
one piece of Information ends and the next begins. BASIC expects to find an ex- 
act Order separated by commas. 


The form of the BASIC Statement looks like this: 
Line 

Number Statement 
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• Use the comma to separate optional values and variable names. You can input 
any number of variable names on a single 1 ine with an INPUT Statement. The 
variable names are of your own invention. You can have as many of them as 
you like as long as you separate them with a comma. For example, INPUT 
A,B,C,D,E teils the Computer to expect five values from the keyboard 

• Use the comma to space advance to the next output field in a PRINT Statement. 
When used in a PRINT Statement at the end of a quoted String or between ex- 
pressions, the comma will advance printing to the next column which is a multi¬ 
ple of 14. For example, if X is assigned the value of 25 then the Statement 10 
PRINT "YOU ARE", X, "YEARS OLD" will have the following spacing when you 
run it: 


-*-14 columns-*- 


-*-14 columns-»- 


YOU ARE 25 

YEARS OLD 


USE OF SEMICOLON IN PRINT STATEMENT 

The semicolon is used for PRINT Statement output. The semicolon leaves one space 
after variables and constants separated by semicolons. A positive number printed with 
semicolons will have a leading blank space. Negative numbers will have a minus sign 
and no preceding blank space. For example, if X is assigned the value of 25, then the 
Statement 10 PRINT "YOU ARE";X;"YEARS OLD" will have the following spacing when 
the program is run: 

YOU ARE 25 YEARS OLD 


If X is assigned the value of -25, then the Statement 10 PRINT "YOU ARE";X;"YEARS 
OLD" will have the following spacing when the program is run. 

YOU ARE-25 YEARS OLD 


If you want more than one space left before and after the 25 you must leave the space 
in the String within the quotes. Thus, 

10 PRINT "YOU ARE ";25YEARS OLD" 


will give the following spacing when the program is run: 
YOU ARE 25 YEARS OLD 


The semicolon can also be used to bring two PRINT Statements, String constants, or 
variables together on the same line of the television screen. For example: 

100 PRINT "THE AMOUNT IS 
120 AMOUNT = 20 

125 REM BOTH STRING CONSTANT AND VARIABLE 

126 REM WILL PRINT ON THE SAME LINE 
130 PRINT AMOUNT 
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THE COLON 


The colon is used to join more than one Statement on a line with a single line number. 
Thus, many Statements can execute under the same line number. By joining more than 
one Statement on a single line, the program requires less memory. 

For example: 

10 X = 5:Y = 3:Z = X + Y:PRINT Z.END 

Many times this also helps the programmer organize the program steps. The same pro¬ 
gram with line numbers instead of colons uses more bytes of memory: 

10 X = 5 
20 Y = 3 
30 Z = X+Y 
40 PRINT Z 
50 END 
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EDITING 


KEYBOARD The ATARI 800 Computer keyboard has features that differ from those of an ordinary 

OPERATION typewriter. To print lowercase letters on your television screen, press the 

key. The keyboard will now operate like a typewriter, with the ü mü§ key giving upper- 
case letters. Since most BASIC programs are written in uppercase, you will normally 
want to return to the uppercase mode. Press the fgjjjJJJI key and hold it down while you 
press the key to return to uppercase letters. 


SPECIAL 

FUNCTION 

KEYS 



Inverse (Reverse) Video Key or ATARI logo key. Press this key to 
reverse the text on the screen (dark text on light background). 
Press key a second time to return to normal text. 

Lowercase Key. Press this key to shift the screen characters 
from uppercase (capitals) to lowercase. To restore the 
characters to uppercase , press the key and the 
key simultaneously. 

Escape Key. Press this key to enter a command to be entered in- 
to a program for later execution. 

Example: To clear the screen, enter: 


10 PRINT 


and press Then, whenever line 10 is executed the screen 

will be cleared. 


fH§ is also used in conjunction with other keys to print special 
graphics control characters. See the graphics in Appendix K for 
specific keys and their screen-character representations. 

Break Key. Press this key to stop your program. You may 
resume execution by typing CONT and pressing ÜlifBfS I. 

System Reset Key. This key is similar to SWfäM in that it also 
stops program execution. Use this key to return the screen 
display to graphics mode 0, and to clear the screen. 
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ISäg'I TJiBi Tab Key. Press t SüH and the kevs simultaneously to 

set a tab. To clear a tab, press the ffBÜK and ^ AtUWSHMI keys 
simultaneously. Used alone, advances the Cursor to 

the next tab Position. In deferred mode, set and clear tabs by 
adding a line number, the command PRINT, and a quotation 
mark, and pressing the MSM key. 

Examples: 


100 PRINI " ■: ... , 

200 PRINI ", ■- 


If tabs are not set, they default to columns 7,15, 23, 31, and 39. 


iffESfff i Insert Key. Press the gfflgj and jj||||gj keys simultaneously to 

insert a line. To insert a single character, press the jjgyEEI and 
keys simultaneously. 


CURSOR ln addition to the special function keys, there are Cursor control keys that allow im- 

CONTROL KEYS mediate editing capabilities. These keys are used in conjunction with the fggjggor fUU§ 

keys. The keys that öfter special editing features are described in the following 
paragraphs. 

ist Hold the control key down while pressing the arrow keys to 

produce the Cursor control t'unctions that allow you to 
move the Cursor anywhere on the screen without changing 
any characters already on the screen. Other key combina- 
tions set and clear tabs, halt and restart program lists, and 
control the graphics Symbols. Striking a key while pressing 
the f3ig|| key will produce the upper left Symbol on those 
keys that have three functions. 


asm Moves Cursor up one line without changing the program or 

display. 

ÖfcSSSI Moves Cursor one space to the right without disturbing the 

program or display. 

llliMliiiäi Moves Cursor down one line without changing the program 

or display. 

tüjSpgfsfnl Moves Cursor one space to the left without disturbing the 

program or display. 

vji '-i- 'aiHEHSni Inserts one character space. 

MM amamms Deletes one character or space. 

§3p!|1. Temporarily stops and restarts screen display. You can use 

tSSBl l while listing a program or while running a program. 

§gjg§2. Rings buzzer. 
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Hold the faa key down while pressing the numeric keys to display the Symbols 
shown on the upper half of those keys. 


SHIFT I INSfcRT 


SWIFT I BACK 


CAPS LOWR 


mm 


Inserts one line. 

Deletes one line. 

Returns screen display to uppercase alphabetic characters. 

Stops program execution or program list, prints a > on the 
screen, and displays the Cursor (|) underneath. 
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SINGLE- 

PRECISION REAL 
CONSTANTS 


SINGLE- 

PRECISION REAL 
VARIABLES 


CONSTANTS, VARIABLES, 

AND NAMES 


There are five types of constants in Microsoft BASIC: singleprecision real, double- 
precision real, integer, string, and hexadecimal. 

FORM1NG A VARIABLE NAME 

In ATARI Microsoft BASIC a variable name can be up to 127 characters long. The 
allowable characters include the alphabet ABCDEFGHIJKLMNOPQRSTUVWXYZ, 

numbers 1234567890, and underscore (_). The underscore character (_) is a legal 

character in ATARI Microsoft BASIC. Numbers are allowed in variable names as long 
as the variable name Starts with an alphabetic character. The variable name X9 is 
allowed, while 9X is not allowed. 

SPECIFYING PRECISION OF NUMERIC VARIABLES 

After you create a variable name, you can specify the precision of the variable in one 
of two ways. The variable name itself can have a variabletype identifier (none, #, %, $) 
as the last character or you can predefine the starting letter as a variable type using 
DEFSNG, DEFDBL, DEFINT, or DEFSTR. 

PREDEFINING VARIABLE PRECISION 

The advantage of predefining the variable type is that you can change all the variables 
from one type to another without having to go through your program changing all 
variable names. Changing DEFINT A to DEFDBL A, for example, changes all variables 
beginning with the letter A from integer type to double-precision type. Your other Op¬ 
tion is to use a type tag identifier: # (double precision), % (integer), and $ (string). Tag 
identifiers are attached to the end of the variable name itself. If variables should have 
both DEF identification of type and a tag identifier (#, %, $), the tag identifier has 
precedence. 

Although DEFSNG, DEFDBL, DEFINT, and DEFSTR can be placed anywhere in a pro¬ 
gram, they are usually placed near the beginning. In all cases the DEF Statement must 
precede the variable whose type it defines. 


Examples: 65E12, 333335, .45E8, .33E-6 

If you do not otherwise specify a constant(and it is outside the ränge-32768 to 32767), 
it is single-precision real. 


Examples: AMT, LENGTH, BUFFER 

If you do not declare the precision of a variable, it becomes single-precision real by 
default. Numbers stored as single precision have an accuracy of six significant figures. 
The exponential ränge is -38 to +38. 
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DEFSNG 


Format: DEFSNG [etter,| beginning_letter-ending_letter| 

Examples: 100 DEFSNG K, S, A-F 
120 DEFSNG Y 

Variable names beginning with the first letters identified in DEFSNG will be single- 
precision real variables. In DEFSNG K, S, A-F, the letter ränge A-F means ABCDEF will 
be single precision. Variable names starting with K and S will also be single precision in 
this example. Single letters and ranges of letters must be separated by commas. 

Example Program: 

10 DEFSNG A-F 
20 COUNTER = COUNTER+ 1 
30 PRINT COUNTER 
40 GOTO 20 


In the DEFSNG example program, all variable names beginning with the letterC will be 
single precision. Thus, COUNTER is single precision in this example because it Starts 
with C. If counter were COUNTER# (# means double precision), it would have double 
precision even though it is defined as single precision. Keep in mind that the tag iden- 
tifier in a variable name takes precedence. 

Figure 3-1 illustrates how single-precision real numbers are represented in memory. 



BYTE 0 BYTE 1 BYTE 2 BYTE 3 


mantissa sign bit 
exponent sign bit implicit radix point 

Figure 3-1 Machine Representation of Single-Precision Real 


DOUBLE- Examples: 45D5, 23D-6, 8888888D-11 

PRECISION REAL 

CONSTANTS You can s P ec ^V double-precision real in the constant by putting the letter D before the 

exponential part. Double-precision real numbers are stored in 8 bytes. Numbers are ac- 
curate to 16 decimal digits. 
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DOUBLE- 
PRECISION REAL 
VARIABLES 


DEFDBL 


INTEGER 

CONSTANTS 


INTEGER 

VARIABLES 


Examples: DBL#, X#, LG NO# 

The pound sign (#) is the identifier for double-precision real variables. A double- 
precision real variable bas 8 bytes. The exponent and sign are stored in the first byte. 
The ränge is the same as single precision -38 to +38. The accuracy is 16 significant 
figures in double-precision real. The pound sign (#) identifier is placed after the variable 
name. 


Format: DEFDBL letter,|beginning_letter-ending_letterj 

Examples: 10 DEFDBL C-E, Z 
20 DEFDBL R 

Variable names starting with letters identified by the DEFDBL Statement are double- 
precision real. In the example above CDE, Z, and R are all declared as double- 
precision. The variable name El would be a double-precision variable because the 
variable name begins with E. 

Figure 3-2 illustrates how double-precision real numbers are represented in memory. 


EX 


MANTISSA 


BYTE 0 


BYTE 1 


BYTE 2 


BYTE 3 BYTE 4 


BYTE 5 BYTE 6 


BYTE 7 


exponent 
sign hit 


| mantissa sign bit 
implicit radix point 


Figure 3-2 Machine Representation of Double-Precision Variable 


Examples: 23, -9999, 709, 32000 

All numbers in ATARI Microsoft BASIC within the ränge-32768 to 32767 are stored as 
two bytes of binary. If an integer constant is multiplied with a single-precision real 
number, the product of the multiplication will be a single-precision real number. The 
results of mathematical operations are always stored in the higher level precision type. 


Examples: SMALLNO%, }%, COUNT% 

An integer can be identified by having a percent sign (%) as the last character in the 
variable name. An example of an integer identified by name is NO%. The 16-bit integer 
is stored as twos complement binary. 
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DEFINT 


STRING 

CONSTANTS 


STRING 

VARIABLES 
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Format: DEFINT letter,|beginning_letter-ending_letter 

Examples: 10 DEFINT N, J, K-M 
20 DEFINT I 


The starting letters of variable names identified by the DEFINT Statement are integers. 
Integer variables increase the speed of Processing but can only accurately hold values 
between -32768 and +32767. Remember that tag identifiers have precedence. Even 
though N is defined by DEFINT as being an integer type, the pound sign appearing 
after the N identifies it as double precision. N#, NI#, NUMB# are all double precision. 

Figure 3-3 illustrates how integers are represented in memory. 



BYTE 0 BYTE 1 

sign bit 
0 is positive 
1 is negative 


Figure 3-3 Machine Representation of Integer Variable 


Negative integers are stored as twos complement binary. 


Examples: "AMOUNTS", "FILL IN NAME. 


String constants are always enclosed in quotes. The String constant can be any length 
up to the maximum fine length (127). Strings are composed of ANY keyboard 
characters: "!#$%&&"())OOKJHGGFDS." A double-quote character ("") is also allowed. 
The double quote ("") will give you a single quote when the String is printed. 

Example of a String constant used in a print Statement: 

10 PRINT "Strings and %&'$ ""things""" 

20 A$ = "STRING CONSTANTS ASSICNED TO VARIABLE NAME" 

30 PRINT A$ 


Examples: A$, NINT$, ADDRESS$ 

String-variable names end with a dollar sign $. A string variable can be assigned a String 
up to 255 characters. The double-quote ("") character is a legal ATARI Microsoft 
BASIC way of getting a single quote (") within a string. 

Examples of Strings assigned to A$: 

10 A$ = "a string" 

20 A$ = "another ""string""" 



DEFSTR 


HEXADECIMAL 

CONSTANTS 


Format; DEFSTR letter,|beginning_letter-ending_letterj 

Examples: 10 DEFSTR A, K-M, Z 
20 DEFSTR F, J, I, O 

A variable name can be defined as a string by declaring its starting letter in the DEFSTR 
Statement. Strings can be up to the length of 255 characters. As in all variable name 
declarations, the tag identifier has precedence. A# or A% are their tag types even if 
their first letter is defined by DEFSTR. 

Example Program; 

10 DEFSTR A, M, Z 

20 A = "Employee Name AMOUNT" 

30 PRINT A 


The example program will print the heading Employee Name AMOUNT. 


Examples: &76, &F3, &7B, &F3EB 

It is often easier to specify locations and machine language Code in hexadecimal (base 
16) rather than decimal notation. By preceding a number with &, you declare it to be 
hexadecimal. 

To jump to the machine language routine starting at hexadecimal location C305, you 
specify A= USR(&C305,0). A= PEEK (&5A61) will assign the contents of memory loca¬ 
tion 5A61 hex to the variable named A. Hexadecimal is useful in representing screen 
graphics— especially piayer-missile graphics. 


Following is an equivalency fable for decimal, hexadecimal, and binary numbers. 

TABLE 3-1 

DECIMAL, HEXADECIMAL, AND BINARY EQUIVALENTS 


:cimal 

Hexadecimal 

Binary 

1 

1 

0001 

2 

2 

0010 

3 

3 

0011 

4 

4 

0100 

5 

5 

0101 

6 

6 

0110 

7 

7 

0111 

8 

8 

1000 

9 

9 

1001 

10 

A 

1010 

11 

B 

1011 

12 

C 

1100 

13 

D 

1101 

14 

E 

1110 

15 

F 

1111 
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NUMERIC 

EXPRESSIONS 


4 


NUMERIC 
AND STRING 
EXPRESSIONS 


RELATIONAL OPERATORS 

There is no real order of precedence for the relational operators =, < >, >, <=, 
> =. They are evaluated from left to right. 


RELATIONAL AND LOGICAL SYMBOLS 

Because the relational Symbols are evaluated from left to right, you could say that 
their order of precedence is from left to right. The relational Symbols =, < >, <, >, 
< =, > = have precedence over the logical operators NOT, AND, OR, and XOR. NOT 
has the highest precedence, AND ranks next, OR ranks next, and XOR ranks last. 

The relational operators are combined to form expressions. For example: A>B AND 
C<D is an expression. The greater than (>) and less than (<) Symbols are considered 
first, then the AND is evaluated. If the relationship is true, a nonzero number will 
result. If the relationship is not true, then zero will be the result. Nonzero is true and 
zero is false. In an IF Statement this evaluation determines what happens next. The 
ELSE or the next line number is taken when an the expression formed with operators is 
false. 


OPERATOR 


< > or > < 


< 

> 


MEANING 

Equals. This is a true use of the equal sign. It asks if 
A= B. The B is not assigned to A. 

Not Equal. Evaluates whether two expressions are 
not equal. 

Is less than. A is less than B is represented by A<B. 

Greater than. A is greater than B is represented by 
A>B. 


> = or — > 


< = or = < 


Greater than or equal to. A is greater than or equal 
to B is represented by A > = B 

Less than or equal to. A is less than or equal to B is 
represented by < =. 
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ARITHMETIC SYMBOLS 


STRING 

EXPRESSIONS 


The arithmetic Symbols are: (), =, - A, *, /, +, -(the first dash - means negation, the last 
dash means subtraction] The arithmetic Symbols can be mixed with the logical 
operators in creating expressions. The expression A/C > D*A is legal. The arithmetic 
expressions represent mathematical Symbols. The * Symbol represents multiplication. 
The A is used in ATARI Microsoft BASIC to mean exponent The order of precedence 
is: 


SYMBOL 

0 


A 


/ 

+ 


MEANING 

Arithmetic within parenthesis is evaluated first. 
Equals sign. 

Negative number. This is not subtraction but a 
negative sign in front of a number. Example: -3, 
-A, -6. 

Exponent. 

Multiplication. 

Division. 

Addition. 

Subtraction. 


RELATIONAL OPERATORS IN STRINGS 

Relational operators in strings (=, <>, <, >, < = , >=) can accomplish useful 
tasks. Alphabetical order can quickly be achieved by an algorithm using the expression 
A$<B$. A match between names can be found by asking that A$=B$. The String 
variables are evaluated as numbers in ATASCII code and since the ATASCII is ordered 
alphabetically, the evaluation of String expressions is useful. 

SYMBOL MEANING 

A$<B$ True (nonzero) if A$ has a lower ATASCII code 

number than B$. 


Sort Example: 

100 INPUT A$,B$ 

120 IF A$<B$ THEN 160 
130 C$ = A$ 

140 A$=B$ 

150 B$ = C$ 

160 PRINT A$, B$ 

170 END 
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To experiment, type any two word combinations and separate them by commas. The 
words will be sorted into alphabetical Order using the example above. Thus, you will 
see that BILL comes before BILLY, and CAT comes before DOG. 


The logical operators have the following Order of precedence: 

OPERATOR MEANING 

NOT Not. The 8 bits of the number are complemented. If 

it is a binary 1 it becomes a 0 after this logical 
Operation. 

AND The bits of the number are logical ly ANDed. Exam¬ 

ple: A AND B. If A is 1 and B is 1 the result is 1. If A 
is 1 and B is 0 the result is 0. If A is 0 and B is 1 the 
result is 0. If A is 0 and B is 0 the result is 0. 

OR The bits of the number are logically ORed. Exam¬ 
ple: A OR B. If A is 1 and B is 1 the result is 1. If A is 

1,and B is 0 the result is 1. If A is 0 and ß is 1 the 

result is 1 If A is 0 and B is 0 the result is 0. 

XOR The bits of the number are logically eXclusive 

ORed. Example: A XOR B. If A is 1 and B is 1 the 

result is 0. If A is 1 and B is 0 the result is 1. If A is 0 
and B is 1 then the result is 1 If A is 0 and B is 0 then 
the result is 0. 


The logical operators can be used with String (A$) variables. Read Section 10 on string 
expressions. 
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COMMANDS 


ln ATARI Microsoft BASIC, Statements are not evaluated for syntax errors until you 
type RUN and press the key. 


NEW Format: NEW 

Examples: NEW 

100 IF CODE < >642 THEN NEW 


NEW clears your program to allow you to enter a new program. The NEW command 
does not destroy TIME$. All variables are cleared to zero and all strings are nulled 
when NEW is executed. 


RUN Format: RUN |"device:program_name"| |optional_starting_line_number| 

Examples: RUN 

RUN 120 

200 RUN "D:TEST,BAS" 

110 RUN 200 

RUN without a line number Starts executing your program with the lowest line 
numbered Statement. RUN initializes all numeric variables to zero and nulls String 
variables before executing the first Statement in the program. 

RUN can be used in the deferred mode (with a line number). Refer to the program on 
the next page. It can also be used to enter a program from diskette or cassette. 
However, when RUN is used to run a program on diskette or cassette (i.e., RUN 

"D:SHAPES"), it cannot be used with |optional_starting_line_number|, which can 

only be used to run programs that are already in memory. 

Example: 200 RUN "D:TEST 

When Statement line number 200 is executed, it will run the program called TEST. 
RUN can be used to run tokenized (saved with the SAVE instruction) programs only. 
RUN can be used to Start executing a program at a particular line number. 

Example: RUN 250 

When RUN is executed in a program, as mentioned earlier, all numeric variables are 
set to zero and all strings are nulled. 
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Example Program: 


100 X = 55 
110 Y —77 
120 A$ = "A TEST" 

130 PRINT X,Y,A$ 

140 RUN 150 

150 PRINT X,Y,A$,"Variables are 0 and String is null" 
160 END 


DOS Format: DOS 

Example: DOS 

The DOS command lets you leave BASIC and enter the DOS Menu. This makes 
available all of the DOS Menu items on programs and data stored on diskette. To 
return to ATARI Microsoft BASIC, press the ffSffgKSf jjj key. This method of exiting 
DOS will keep your program exactly as it was before you entered DOS. 

LIST Format: LIST |"device:program name"| |m-n| 

Examples: 100 LIST 

150 LIST "C: 

120 LIST "P:" 10-40 
100 LIST "D:CRAFX.BAS 
110 LIST 100-200 
100 LIST -300 

LIST writes program Statements currently in memory onto the television screen or 
another device. If "device:program_name" is present, the program Statement current¬ 

ly in memory is written onto the specified device. 

Legal device names include: D: (for Disk), C: (for Cassette), P: (for Printer). If you do not 
follow LIST with a device name, the screen (S.) is assumed. 

When you list programs on the screen, it is often convenient to freeze the list while it is 
scrolling. To freeze a listing, press both the JSljJI and 1 key at the same time. To con- 
tinue the listing, again press F SjlM and 1 at the same time. 

With the LIST command you can list just one Statement or as many as you wish. A - 
(hyphen) is used to specify the ränge of Statements: 


LIST 

Lists the whole program from lowest line number to the 
highest. 

LIST n 

Lists only the Statement n (where n is a Statement 
number). 

LIST -m 

Listing Starts with the first Statement in the program and 
stops listing with Statement m. Statement m is listed. 

LIST n- 

Listing Starts with Statement number n and continues to 
the last Statement number in the program. 

LIST n-m 

Listing Starts with n and ends with m. Both Statements n 
and m are included in the listing. 
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Example: 

100 REM Example of the list 
110 REM Command 

120 PRINT "SHOWS WHICH STATEMENTS" 
130 PRINT "OR GROUP OF STATEMENTS" 
140 PRINT "GET LISTED" 


LIST 110-130 


110 REM Command 

120 PRINT "SHOWS WHICH STATEMENTS" 
130 PRINT "OR CROUP OF STATEMENTS" 


Example of LIST used in deferred mode: 

10 COUNT = 1 

20 COUNT = COUNT-f 1 

30 PRINT COUNT 

40 IF COUNT < > 30 THEN 20 

50 LIST 


Use LIST to list a program on a printer. This is done in direct mode. 

LI ST"P: 

Use LIST to list a program in untokenized ASCII form onto a diskette. To list to diskette 
use: 

LIST"D:name.ext 

Use LOAD when you are entering untokenized (listed) programs into your Computer. 
LOAD can be used to enter programs that have been listed or saved to cassette or 
diskette. 


AUTO 


Format: AUTO |n,i| 
Examples: AUTO 200,20 
AUTO 


AUTO numbers your lines automatically. If you do not specify n,i (starting number, in- 
crement) you will get line numbers starting at 100 with an increment of 10. Use AUTO 
when you Start writing a program. Type AUTO, then type a starting line number. (See 
the example on the following page.) Then type the amount you want the numbers to in- 
crease. After you Start the AUTO numbering, you will automatically have a new line 
number every time you type a Statement and press ISÜt CTv. To stop AUTO, press 
j by itself without typing a Statement. AUTO can also be stopped by pressing the 
key. 
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Example Program: 

AUTO 300,20 fStf'Si Starts numbering at 300 and increments by 

20 

300 PRINT "THIS SHOWS HOW" 

320 PRINT "AUTO NUMBERING" 

340 PRINT "WORKS" 

360 $23523 

■ 

AUTO numbering ends when you press gSSSJS right after a line number. If there is an 
existing line at that number, the line will be displayed on your television screen. 


DEL Format: DEL n-m 

Examples: DEL 450 - 

DEL 250 - 350 
DEL - 250 

DEL deletes program Statements currently in memory. With the DEL command you 
can delete just one Statement or as many as you wish. A - (hyphen) is used to specify 
the ränge of Statements: 

DEL n Deletes only the Statement n (where n is a Statement 

number). 

DEL -m Deletion Starts with the first Statement in the program and 

' stops with Statement m. Statement m is deleted. 

DEL n- Deletion Starts with Statement number n and continues to 

the last Statement number in the program. 

DEL n-m Deletion Starts with n and ends with m. Both Statements n 

and m are deleted. 

Example Program: 

100 PRINT "AN EXAMPLE OF" 

120 PRINT "HOW THE DELETE" 

130 PRINT "COMMAND WORKS" 

DFL 120- gEBtEMI 

Only Statement 100 is left in memory. 

LIST gfflBU 

100 PRINT "AN EXAMPLE OF" 
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SAVE 


SAVE.. 


LOAD 


If you want to delete a single Statement from a program, simply type the Statement 
number and press m 

Example Program: 

110 FOR X = 1 TO 5000:NEXT 

HO ans 


Format: SAVE "device:program_name" 

Example: SAVE "D:GAME.BAS" 

SAVE copies the program in memory onto the file named by program _ name. Legal 

devices are D: (for disk), C. (for cassette). For example, the command SAVE 
"D:TEMP.BAS" will save the program currently in memory onto diskette. The program 
is recorded in "tokenized" form onto tape or diskette. 

Example: 

SAVE "D:PROCRAM" 

Saves PROGRAM on diskette. 

SAVE "C: 

Saves the program on cassette. 


.LOCK Format: SAVE "device:program_name" LOCK 

Example: SAVE "D:PROGRAM.EXA" LOCK 

SAVE "device:program_name" LOCK saves a program onto tape or diskette and en- 

codes it so that it cannot be edited, listed, merged, examined, or modified. LOCK is 
used to prevent program tampering and theft. 


Format: LOAD "device:program_name" 

Examples: LOAD "D:EXAMPLE" 

110 LOAD "C:" 

LOAD "device:program_name" replaces the program in memory with the one 

located on device:. Disk drive or cassette can be specified for device:. Use LOAD "C:" 
to load data or listed cassette files. For programs that have been previously saved use 

CLOAD to increase loading speed. For diskette files, use "D.program_name" for listed 

programs or saved programs. 
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CLOAD 


CSAVE 


VERIFY 


MERGE 


Format: CLOAD 
Examples: CLOAD 

440 CLOAD 

Use CLOAD to load a program from cassette tape into RAM for execution. When you 
enter CLOAD and press ffi BlfllL the in-cabinet buzzer sounds. Position the tape to the 
beginning of the program, using the tape counter as a guide, and press PLAY on the 
ATARI 410™ Program Recorder. Then press the flflllll key again. Specific instructions 
to CLOAD a program are contained in the ATARI 410 Program Recorder Operators 
Manual. 


Format: CSAVE 
Examples: CSAVE 

330 CSAVE 

CSAVE saves a RAM-resident program onto cassette tape. CSAVE saves the tokenized 
(compacted) version of the program. As you enter CSAVE and press C Sfflgl. the in- 
cabinet buzzer sounds twice Signaling you to press PLAY and RECORD on the Program 
Recorder. Then press fgSjjjKgg again. Do not, however, press these buttons until the tape 
has been positioned. Saving a program with this command is speedier than with 
SAVE"C." because short inter-record gaps are used. Use SAVE"C:" with LOAD"C:'' or 
CSAVE with CLOAD but do not mix these paired Statements — SAVE"C:" with CLOAD 
will give you an error message. 


Format: VERIFY "device.program_name" 

Examples: VERIFY "D:BIO.BAS" 

VERIFY "C: 

VERIFY compares the program in memory with the one named by "device:pro- 
gram_name". If the two programs are not identical, you get a TYPE MISMATCH ER¬ 

ROR. 


Format: MERGE "device:program_name" 

Examples: MERGE "D:STOCK.BAS" 

MERGE "C: 

Use MERGE to merge the program stored at "device:program_name" with the pro¬ 

gram in memory. Only programs that have been saved using the LIST instruction to put 
them on diskette or cassette can be merged. If duplicate line numbers are en- 

countered, the line on "device:program_name" will replace the one in memory. On 

the following page, you can see an example of merging programs. 

Example Program: 

100 REM THIS IS A PROCRAM 
120 REM STORED ON DISKETTE 
130 PRINT "MERGE TEST" 
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LIST "D:STOCK.BAS" 


110 REM THIS PROCRAM IS 
125 REM IN COMPUTER MEMORY 
140 PRINT "RESULT" 


MERGE "D:STOCK.BAS" 

LIST 

100 REM THIS IS A PROCRAM 
110 REM THIS PROGRAM IS 
120 REM STORED ON DISKETTE 
125 REM IN COMPUTER MEMORY 
130 PRINT “MERGE TEST" 

140 PRINT “RESULT" 


RENUM 


Format: RENUM |m, n, i| 
Example: RENUM 10,100,10 


m = The line number to be applied to the first renumbered Statement, 
n = The first line number to be renumbered. 
i = The increment between generated line numbers. 


RENUM gives new line numbers to specified lines of a program. The line number to 
be applied to the first renumbered Statement is the first Parameter. The first line 
number to be renumbered is the next parameter. The increment or amount of in- 
crease between numbers is the last parameter. 

The default of RENUM is 10, 0, 10. 

Renumber changes all references following GOTO, GOSUB, THEN, ON...GOTO, 
ON...GOSUB, and ERROR Statements to reflect the new line numbers. 

Note: RENUM cannot be used to change the Order of program lines. For example, 
RENUM 15, 30 would not be allowed when the program has three lines numbered 
10, 20, and 30. Numbers cannot be created higher than 63999. 


RENUM 


Renumbers the entire program. The first new line number 
will be 10. Lines will increment by 10. 


RENUM 10,100 The old program line number 100 will be renumbered 10. 

Lines increment by 10 (the default is 10). 

RENUM 800,900,20 Renumbers lines from 900 to the end of the program. Line 
900 now is 800. The increment is 20. 
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RENUM 300, 140, 20 gives number 300 to line 140 when it is encountered . The incre- 
ment is 20. 


LOCK 


UNLOCK 


KILL 


NAME...TO 


TRON 


BEFORE 

AFTER 

100 

100 

110 

110 

120 

120 

130 

130 

140 

300 

150 

320 

160 

340 

170 

360 


Format: LOCK "device:file_name" 

Example: LOCK "D:CHECKBK" 

LOCK is the same LOCK that exists in the DOS Menu. LOCK ensures that you do not 
write over a program without first unlocking it. As a BASIC command, LOCK öfters a 
measure of protection against accidental erasure. 


Format: UNLOCK "device:program_name" 

Example: UNLOCK "D:CAME1 BAS" 

The UNLOCK Statement restores a file so that you can write to, delete, or rename it. 


Format: KILL "device:program_name" 

Example: KILL "D:PROC1 .BAS" 

KILL deletes the named program from a device. 


Format: NAME "device:program_name_1" TO "program_name_2" 

Example: NAME "D:BALANCE" TO "CHECKBK" 

NAME gives a new name to "device:program_name_1." The device (Dl: through 

D8:) must be given for the old program, but the new program name enclosed in quotes 
is the only thing following the word TO. 


Format: TRON 
Examples: TRON 

550 TRON 

This command turns on the trace mechanism. When TRON is on, the number of each 
line encountered is displayed on your television screen betöre it is executed. Use 
TRON in direct or deferred mode. 


26 Commands 



TROFF 


Format: TROFF 
Example: 770 TROFF 


This command turns off the trace mechanism. Use TROFF in direct or deferred mode. 
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STATEMENTS 


REM or ! or ' Format: REM 

Example: 10 REM THIS PROCRAM COMPUTES THE AREA OF A SPHERE 
20 LET R = 25 !Sets an initial value 
30 GOSUB 225 'GO TO COMPUTATION SUBROUTINE 
65 PRINT R:REM PRINTS RADIUS 

Format: ! and ' 

Example: 10 PRINT "EXAMPLE" ITAIL COMMENTS 
20 GOTO 10 ! USE ! and ' 

The exclamation point (!) and the accent (') are used after a Statement for comments. 
REM must Start right after the line number or colon, while ! and ' do not require a 
preceding colon. 

REM, !, and ' are used to make remarks and comments about a program. REM does not 
actually execute. Although REM does use RAM memory, it is a valuable aid to reading 
and documenting a program 


LET Formats: |LET| variable name = |arithmetic expression| or j String expression| 

variable_name = |arithmetic_expression| or ]String_expression| 

Example: 100 LET COUNTER = 55 
120 D = 598 

LET assigns a number to a variable name. The equal sign in the LET Statement means 
"assign," not "equal to" in the mathematical sense. For example, LET V = 9, assigns a 
value of 9 to a variable named V. The number on the right side of the equal sign can be 
an expression composed of many mathematical Symbols and variable names. Thus, 
LET V = (X + Y-9)/(W*Z) is a legal Statement. 

The word LET is optional in assignment. All that is necessary for assignment is the 
equal sign. Thus, 

100 LET THIS = NUMBER * 5 

is the same as: 

100 THIS = NUMBER * 5 
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MOVE 


STOP 


CONT 


END 


GOTO 


Format: MOVE from_address, to_address, no_of_bytes 

Example: 20 MOVE MADDR1, MADDR2, 9 

The MOVE Statement moves bytes of memory from the area of memory whose lowest 

address is given by the first numeric expression (from_address) to the area whose 

lowest address is given by the second numeric expression (to_address). The third 

numeric expression specifies how many bytes are to be moved. The Order of move¬ 
ment is such that the contents of the block of data are not changed by the move. 
MOVE's primary use is in player-missile graphics. 

Example: MOVE 55,222,5 

Five bytes with a starting low address at 55 (i.e., 55-60) will be moved to location 
222-226. 


Format: STOP 
Example: 190 STOP 

STOP is used to halt execution of a program at a place that is not the highest 1 ine 
number in the program. The STOP command prints the line number where execution 
of the program is broken. STOP is a useful debugging aid because you can use PRINT 
in the direct mode to show the value of variables at the point where execution halts. 
Also, -you know that your program got as far as the STOP command. 


Format: CONT 
Example: CONT 


CONT resumes program execution from the point at which it was interrupted by either 
STOP, the ggj]||§ key, or a program error. This instruction is often useful in debugging a 
program. Ä breakpoint can be set using the STOP Statement. You can check variables 

at the point where execution stops by using PRINT variable _ name in the direct mode 

(without a line number). Then resume the program by using the CONT Statement. 


Format: END 
Example: 990 END 

END halts the execution of a program and is usually the last Statement in a program. 
When END terminates a program, the prompt character appears on the screen. In 
ATARI Microsoft BASIC, it is not necessary to end a program with the END Statement. 


Format: GOTO line_number 

Example: 10 GOTO 110 

GOTO teils which line number is executed next. Normally, Statements are executed in 
order from the lowest to highest number, but GOTO changes this Order. GOTO causes 
a branch in the program to the line number following GOTO. 

Example: GOTO 55 
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IF...THEN 


IF...THEN.. 


WAIT 


Since this Statement does not have a line number, it Starts immediate execution of the 
program in memory starting at line number 55. 

100 PRINT "THIS IS A COMPUTER" 

120 GOTO 100 


RETURN 


This program will cause endless branching to line number 100. Thus, the television 
screen quickly fills up with THIS IS A COMPUTER. 


Format: IF test_condition THEN goto_line_number or a_Statement 

Examples: 10 IF A—B THEN 290 

20 IF J >Y AND J <V THEN PRINT "OUT OF STATE TAX" 

If the result of an IF...THEN test is true, the next Statement executed is goto _ line 

_ number. A test is made with the relational or mathematical operators. The test can 

be made on numbers or strings. The words GOTO after THEN are optional. If the State¬ 
ment test, test _ condition, is false, the execution goes to the next numbered line in the 

program. 

160 IF A_NUMBER > ANOTHER_NUMBER THEN 300 

200 PRINT "ANOTHERNUMBER IS LARCER" 

250 STOP 

300 PRINT "ANUMBER IS LARCER" 

450 END 


ELSE 


Format: IF test_condition THEN goto_line_number or Statement ELSE 

goto_Jine_number or Statement 

Example: 250 IF R<Y THEN 450 ELSE 200 

This is the same as IF...THEN except that execution passes to the ELSE clause when the 
relational or mathematical test is untrue. 


Format: WAIT address, AND_mask_byte, compare_to_byte 

Example: 330 &D40B,&FF,110 IWAIT FOR VBLANK 

WAIT stops the program until certain conditions are met. Execution waits until the 

compare_to_byte, when ANDed with the AND_mask_byte, equals the byte con- 

tained in memory location address. 

WAIT is ideal if you need to halt execution until VBLANK occurs. VBLANK occurs 
every 1/60 of a second. It consists of a number of lines below the visible scan area.You 
can make sure that your screen will not be interrupted halfway through its scan lines 
(causing the screen to blip) if you WAIT until a VBLANK occurs. This technique is used 
to animate characters as shown in Appendix C, Alternate Character Sets. See Appendix 
A for an example of the WAIT Statement used to control the timing of vertical fine 
scrolling. 


Statements 31 



FOR...TO...STE P Format: FOR starting_variable = starting_value TO ending-value STEP |increment| 

Examples: 10 FOR X = 1 TO 500 STEP 3 
30 FOR Y=20 TO 12 STEP-2 
20 FOR COUNTER = 1 TO 250 

The FOR/NEXT Statement Starts incrementing numbers by increment until end- 

ing _ number is reached. When the ending number is counted, execution goes to the 

Statement number after the NEXT Statement. 

FOR/NEXT determines how many times Statements between the line numbers of the 
FOR...TO...STEP and the NEXT are executed repeatedly. If STEP is omitted, it is as- 
sumed to be 1. STEP can be a negative number or decimal fraction. 

Example Program: 

100 FOR X —1 TO 30 
110 PRINT X, SQR(X) 

120 NEXT 


NEXT Format: NEXT |variable_name| 

Examples: 30 NEXT J,l 
40 NEXT VB 
120 NEXT 

NEXT transfers execution back to the FOR. TO line number until the TO count is up. 
NEXT does not need to be followed by a variable name in Microsoft BASIC. When 
NEXT is not followed by a variable name, the execution is transferred back to the 
nearest FOR...TO Statement. 

Example Program: 

100 FOR X = 10 TO 100 STEP 10 
110 PRINT X 
120 NEXT 
130 END 


RUNSS 

10 

20 

30 

40 

50 

60 

70 

80 

90 

100 


Two or more starting-variables can be combined on the same NEXT line with commas. 
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GOSUB 


RETURN 


ON...GOTO 


Example Program: 

100 FOR X = 1 TO 20 
110 FOR Y = 1 TO 20 
120 FOR Z = 1 TO 20 
130 NEXT Z,Y,X 


SUBROUTINES 

A subroutine is a group of Statements that you wisFi to use repeatedly in a program. 
The GOSUB Statement gives execution to the group of Statements. RETURN marks the 
end of the subroutine and returns execution to the Statement after the GOSUB State¬ 
ment. 


Format: GOSUB line_number 

Example: 330 GOSUB 150 

GOSUB causes line _ number to be executed next. The Statement starting with 

line _ number is the Start of a group of Statements you wish to use a number of times in 

a program. 


Format: RETURN 
Example: 550 RETURN 

RETURN returns the program to the line number after the GOSUB Statement which 
switched execution to this group of Statements. 


Example Program: 

110 GOSUB 140 

120 PRINT "THIS IS THE END" 

130 STOP 

140 PRINT ''THIS IS THE START" 

150 PRINT "OF CODE WHICH" 

160 PRINT "IS EASY TO CALL" 

170 PRINT "(EXECUTE) A NUMBER" 

180 PRINT "OF TIMES IN A" 

190 PRINT "PROGRAM" 

200 RETURN ! EXECUTION CONTROL GOES TO LINE NUMBER 120 


Format: ON arithmetic _ expression GOTO line_number_1, line_number_2, 

line_number_3 

Example: 400 ON X GOTO 550, 750, 990 

ON...GOTO determines which line is executed next. It does this by finding the number 

represented by the arithmetic _ expression and if the number is a 1, control passes to 

line _ number _7. If the number is a 2, control passes to line _ number _2. If the 

number is a 3, control passes to line _ number _ 3, etc. 
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ON...GOSUB 


ON ERROR 


ERROR 


Format: ON arithmetic_expression COSUB line_number_.1, line—number—2, 

line_number_3 

Example: 220 ON X COSUB 440, 500, 700 

ON...COSUB determines which line is executed next. It does this by finding the number 

represented by the arithmetic _ expression. If the number is a 1 then execution passes 

to line _ number _7. If the number is a 2, execution passes to line _ number _2, or If 

the number is a 3, execution passes to line _ number _ 3, etc. 

RETURN is used to transfer execution back to the Statement directly after the COSUB. 
Example Program: 

110 ON X COSUB 333, 440, 512, 620 


333 B= B + C 
340 RETURN 


Format: ON ERROR line_number 

Example: ON ERROR 550 

Program execution normally halts when an error is found and an error message prints 
on the television screen. ON ERROR traps the error and forces execution of the pro¬ 
gram to go to a specific line number. 

The ON ERROR line _ number Statement must be placed before the error actually oc- 

curs in order to transfer execution to the specified line _ number. 

To recover normal execution of the program, you must use the RESUME Statement. 
The RESUME Statement transfers execution back into the program. 

When RUN, STOP, or END is executed, the ON ERROR Statement is terminated. 

Example Program: 

10 ON ERROR 1000 
20 PRINT #3, "LINE" 

30 STOP 

1000 PRINT "DEVICE NOT OPENED YET" 

1010 STOP 
1020 RESUME 

The ON ERROR line _ number Statement can be disabled by the Statement: ON ER¬ 

ROR GOTO 0. If you disable the effectof ON ERROR within the error-handling routine 
itself, the current error will be processed in the normal way. 


Format: ERROR error_code 

Example: 640 ERROR 162 

ERROR followed by an error _ code forces BASIC to evaluate an error of the specified 

error _ code type. Forcing an error to occur is a technique used to test how the pro¬ 

gram behaves when you make a mistake. A complete listing of error Codes is given in 
Appendix M. You can force both System errors and BASIC errors. 
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ERL 


ERR 


AFTER 


CLEAR STACK 


STACK 


RESUME 


Format: ERL 

Example: 100 PRINT ERL 

ERL returns the line number of the last encountered error. 


Format: ERR 

Example: 120 PRINT ERR 

150 IF ERR = 135 THEN GOTO 350 

ERR returns the error number of the last encountered error. 


Format: AFTER (time in 1/60 of a sec) |GOTO| line number 

Example: 100 AFTER (266) GOTO 220 

When AFTER (...) is executed, a time count Starts from 0 up to the number of 1/60 of a 
second (called jiffies). When the time is up, program execution transfers to 

line _ number. AFTER can be placed anywhere in a program but it must be executed in 

order to start its count. A time period up to 24 hours is allowed. 

When RUN, STOP, or END is executed the AFTER Statement jiffie count is reset. 


Format: CLEAR STACK 
Example: 100 CLEAR STACK 

CLEAR STACK clears all current time entries. CLEAR STACK is a way to abort the 
AFTER Statement. If certain conditions are met in a program, you may wish to cancel 
the AFTER Statement. 

Example Program: 

100 AFTER (1333) GOTO 900 
150 IF A=B THEN CLEAR STACK 
900 PRINT "YOUR TURN IS OVER" 

910 RESUME 


Format: STACK 

Examples: 120 PRINT STACK !Prints no. of stack entries available 
310 IF STACK = 0 THEN PRINT "STACK FULL" 

The STACK function gives the number of entries available on the time stack. The time 
stack can hold 20 jiffie entries. The STACK is used to hold the SOUND and AFTER jiffie 
times. This is a random stack since when a jiffie is up, time expires regardless of when 
the jiffies were put in the STACK. 


Formats: RESUME line_number| 

RESUME NEXT| 
RESUME 

Examples: 300 RESUME 55 

440 RESUME NEXT 
450 RESUME 
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OPTION BASE 


CLEAR 


COMMON 


RESUME is the last Statement of the ON ERROR line _ number error handling routine. 

RESUME transfers control to the line _ number. 

RESUME NEXT transfers execution to the Statement following the occurrence of the 
error. 

RESUME transfers execution back to the originating (error causing) line number if you 
do not follow RESUME with NEXT or line _ number. 


Formats: OPTION BASE 0 
OPTION BASE 1 
Example: 150 OPTION BASE 1 

200 DIM Z (25,25,25)!array element subscripts no. 1-25 

OPTION BASE 1 declares that list and array subscript numbering will Start with 1 The 
OPTION BASE (0/1] Statement should be the first executable Statement in a program. It 
States that you want the subscripted variables to begin with 0 or 1. If the OPTION 
BASE Statement is omitted, lists' and arrays' subscript numbering Starts at 0. 

Example Program: 

100 REM DEMONSTRATES OPTION BASE 1 STATEMENT 
110 OPTION BASE 1 
120 DIM ARRAY (15,15) 

150 READ ARRAY (1,1), ARRAY (2,2), ARRAY (15,15) 

165 DATA 32,33,34 

180 PRINT ARRAY (1,1), ARRAY (2,2), ARRAY (15,15) 

190 END 


Format: CLEAR 
Examples: CLEAR 

550 CLEAR 

CLEAR zeros all variables and arrays, and nulls all strings. If an array is needed after a 
CLEAR command, it must be redimensioned. 


Formats: COMMON variable_narrte, |variable_name 

COMMON ALL 

Examples: 110 COMMON I, J, AS, H%, DEC, F() 

100 COMMON ALL 


Use COMMON to keep variable values the same across program runs. COMMON 
makes variables in two programs the same variable in fact as well as in name. If you 
name a variable COUNT in one short program and join that program with another pro¬ 
gram that has COUNT as a variable, the program will consider the COUNTs to be dif¬ 
ferent variables. The COMMON Statement says that you want both COUNTs to be 
considered the same variable. COMMON ALL keeps all previous variable values the 
same across the new program run. 
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Example Program: 


RANDOMIZE 


OPTION PLM1, 
OPTION PLM2, 
OPTION PLMO 


100 COMMON X 
110 X = 4 

120 RUN "D:PROG2" 


BREAK 


print x mmm 

The value of X=4 after line 120 calls the new program is 4. If there is already a variable 
named X in the second program, then X gets its value from the new program. 


Format: RANDOMIZE |seed| 

Exampies: 10 RANDOMIZE 

10 RANDOMIZE 55 ISets a certain repeatable sequence 

RANDOMIZE assures that a different random sequence of numbers will occur each 
time a program with the RND arithmetic function is run. RANDOMIZE gives a random 
seed to the starting point of the RND sequence. 

Example Program: 

100 RANDOMIZE 
110 PRINT RND 
120 END 

Each time you run the above program, a unique number prints on the television screen. 

The RND arithmetic function will repeat the same pseudo-random number each time a 
program is run without RANDOMIZE. In testing a program it is sometimes ideal to 
have an RND sequence that you know will be the same each time. In this case, use the 
RND function by itself without RANDOMIZE. Another way to produce a long se¬ 
quence that will be the same each time, is to use RANDOMIZE |seed| (where |seed| is 
an arbitrary number). But if you wish to see a different set of cards each time you play 
the game, just use RANDOMIZE by itself somewhere near the Start of your program. 

Example of RND without RANDOMIZE: 

100 PRINT RND 
110 END 

Each time you run this program, it prints the same number on the television screen. 


Format: OPTION PLM1 
OPTION PLM2 
OPTION PLMO 
Example: 100 OPTION PLM1 
100 OPTION PLM2 
700 OPTION PLMO 
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OPTION PLM1 reserves 1280 bytes in memory for player-missiles (single-line resolu- 
tion). OPTION PLM2 reserves 640 bytes in memory for player-missiles (double-line 
resolution). OPTION PLMO releases all OPTION PLM reservations. 

The GRAPHICS instruction (see Section 12) must always precede the OPTION PLMn 
Statement. This is because the Computer must first know the graphics mode before you 
reserve space. 

Use OPTION PLM1 or OPTION PLM2 to reserve player-missile memory, clear the 
memory, and set PMBASE. You do not need to worry about the proper memory area to 
place player-missiles when you use the OPTION PLM Statements. To find the exact 
memory location of the starting byte of your missiles, use VARPTR(PLMI) or 
VARPTR(PLM2). 

You must poke decimal location 53277 with decimal 3 in Order to enable player-missile 
graphics. You must also poke decimal location 559 with decimal 62 for single-line 
resolution or decimal 46 for double-line resolution. See Section 13 for an example of 
player-missile graphics. 


OPTION CH RI, 
OPTION CHR2, 
OPTION CHRO 


Format: OPTION CHR1 
OPTION CHR2 
OPTION CHRO 
Examples: 110 OPTION CHR1 
120 OPTION CHR2 
130 OPTION CHRO 


OPTION CHR1 reserves 1024 bytes in memory for character data. OPTION CHR2 
reserves 512 bytes in memory for character data. OPTION CHRO releases all OPTION 
CHR reservations. 


Use OPTION CHR1 or OPTION CHR2 to reserve memory for a RAM character set. You 
can MOVE the ROM character set into the new RAM area you have reserved or you 
can define a totally new character set. VARPTR(CHRI) orVARPTR(CHR2) will point to 
the starting address of the zeroth character. It is necessary to POKE a new starting ad¬ 
dress into CHBAS. This can be done by determining the page to which VARPTR(CHRI) 
or VARPTR(CHR2) is pointing. One way to determine and POKE a new CHBAS is: 

300 CHBAS = &2F4 

310 ADDR% = VARPTR(CHRI) 

320 POKE CHBAS,((ADDR%/256) AND &FF) 

The GRAPHICS instruction (see Section 12) must always precede the OPTION CHRn 
Statement. This is because the Computer must first know the graphics mode before you 
reserve space. 

This procedure will mask for the Most Significant Byte (MSB) of the VARPTR memory 
address and POKE that MSB into CHBAS so you will switch to the new character set. 
See Appendix C for an example of redefining the character set. 
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OPTION 

RESERVE 


VARPTR 


Format: OPTION RESERVE n 
Example: 300 OPTION RESERVE 24 

In the OPTION RESERVE n Statement, n is a number representing the number of bytes 
reserved. For example, OPTION RESERVE 24 reserves 24 bytes. VARPTR(RESERVE) 
can be used to teil you the starting address of the 24 bytes in OPTION RESERVE 24. 
This Statement allows you to reserve bytes for machine code or for another purpose. 


Formats: VARPTRfvariable_name] 

VARPTR(PLMI) 

VARPTR(PLM2) 

VARPTR(CHRI) 

VARPTR(CHR2) 

VARPTR(RESERVE) 

Examples: 110 A = VARPTR(A$) 

100 PRINT VARPTR(A$ + 1) 

120 J = VARPTR(TOTAL) 

120 T = VARPTR(CHR2) 

155 POKE VARPTR(RESERVE),&FE 

If the argument to this function is a variable name, the function returns the address of 
the variable's symbol table entry. When the variable is arithmetic,VARPTR returns the 
variable's 2-byte starting address (Most Significant Byte, Least Significant Byte) in 
memory. When the variable is a string, VARPTR returns the number of bytes in the 
string. Then the starting location of the string is given in VARPTR(A$)+1 Least Signifi¬ 
cant Byte and VARPTR(A$) + 2 Most Significant Byte Notice that only in the case of 
strings is the address given in the 6502 notation of low-memory byte before the high- 
memory byte. Except in the case of strings the whole address in high byte; low-byte for- 
mat is returned with VARPTR. The following keywords can be used with VARPTR. 

VARPTRfPLMn) Returns the address (MSB, LSB) of the first byte allocated 

for PLMn. 

VARPTR(CHRn) Returns the address (MSB, LSB) of the first byte allocated 

for CHRn. 

VARPTR(RESERVE) Returns the address (MSB, LSB) of the first byte allocated 
for assembly language programs. 

Use OPTION PLM1, OPTION PLM2, OPTION CHR1, OPTION CHR2, and OPTION 
RESERVE n to allocate space. Once OPTION has been used to set aside space, 
VARPTR can be used to point to the starting byte of that space. 
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7 


PRINT 


INPUT/OUTPUT STATEMENTS 


The keyboard, disk drive, program recorder, and modern are ways your Computer gets 
Information — Input. The ATARI Home Computer also gives information by writing it 
on the television screen, cassette tape, printer, or diskette — Output. 

ATARI input and output devices have identifying Codes: 

K: Keyboard. Input-only device. The keyboard allows the Computer to get information 
directly from the typewriter keys. 

P: Line Printer. Output-only device. The line printer prints ATASCII characters, a line at 
a time. 

C: Program Recorder. Input and output device. The'recorder is a read/write device that 
can be used as either, but never as both simultaneously. The cassette has two tracks 
for sound and program recording purposes. The audio track cannot be recorded from 
the ATARI Computer System, but may be played back through the television Speaker. 

D1:,D2:,D3:,D4: Disk Drives. Input and output devices. If 32K of RAM is installed, the 
ATARI Computer can use four ATARI 810™ Disk Drives. The default is Dl: if no drive is 
designated. 

E: Screen Editor. Input and output device. This device uses the keyboard and television 
screen (see S: TV Monitor) to simulate a screen editing terminal. Writing to this device 
causes data to appear on the display starting at the current Cursor position. Reading 
from this device activates the screen-editing process and allows the user to enter and 
edit data. Whenever the key is pressed, the entire line is selected as the current 

record to be transferred by Central Input/Output (CIO) to the user program. 

S: TV Monitor. Input and output device. This device allows the user to read characters 
from and write characters to the display, using the Cursor as the screen-addressing 
mechanism. Both text and graphics operations are supported. 

R: Interface, RS-232. The ATARI 850™ Interface Module enables the ATARI Computer 
System to interface with RS-232 compatible devices such as Printers, terminals, and 
plotters. 


Formats: PRINT "string_constant" 

? "string_constant", variable_name 

PRINT variable_name_1, variable_name_2, variable_name_etc 

PRINT#iocb, AT(s,b);X,Y 

PRINT#6, AT(x,y);"string_constant";variable_name 

Examples: 100 PRINT "SORTING PROGRAM";A$,X 

500 ?#6, "ENTERINC DUNGEON" IPrint for GRAPHICS 1 and 2 
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PRINT puts string constants, string variables, or numeric variables on the television 
screen when executed. The PRINT Statement will leave a blank line when executed 
alone. The question mark symbol (?) means the same thing as the word PRINT. 

Example Program: 

100 PRINT "SKIP A LINE" 

120 PRINT 

125 REM NOTE USE OF "" TO PRINT A QUOTE 

130 ANOTHER_LINE$ = "PRINT ""ANOTHER"" LINE" 

140 ? ANOTHER_LINES 

150 END 

Line 120 leaves a blank line when this program is run: 

SKIP A LINE 

PRINT "ANOTHER" LINE 

String constants, string variables, and numeric variables will all print on the same line 
when the line construction includes a comma or semicolon. 

It is not necessary to use a closing quote if you wish to print a string _ constant on your 

television screen: 

100 PRINT "NO CLOSINC QUOTE HERE 

run mss 

NO CLOSINC QUOTE HERE 

PRINT#iocb will print at a particular sector and byte if the disk drive has been 
opened as OUTPUT (see OPEN Statement). The AT clause is quite versatile. If the 
device being addressed is a disk drive, AT(s,b) refers to the sector, byte. However, if the 
device being addressed is the screen, as in PRINT or PRINT#6, then the AT(x,y) refers to 
the x,y screen position. 


An example of printing to a disk drive: 


100 OPEN#3, "D:TEST.DAT" OUTPUT 
110 X = 5 

120 PRINT#3, AT(7,1);"TEST";X 
130 CLOSE#3 


An example of printing to a screen location: 
100 GRAPHICS 1 

110 PRINT#6, AT(3,3);"PRINTS ON SCREEN' 


TAB Format: TAB(n) 

Example: 120 PRINT TAB(5);"PRINT STARTS 5 SPACES IN' 
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SPC 


PRINT USING 


TAB moves the Cursor over the number of positions specified within the parentheses. 
This Statement is used with PRINT to move characters over a number of tabbed 
spaces. 

Example Program: 

100 PRINT TAB (5);"THIS LINE IS TABBED RIGHT FIVE" 

120 END 


Format: SPC(n) 

Example: 10 PRINT TAB (5);"XYZ";SPC (7);"SEVEN SPACES RIGHT OF XYZ" 


SPC puts spaces between variables and constants in a line to be printed. The TAB 
always sets tabs from the left-hand margin. SPC counts spaces from where the last 
variable or constant ends. 


PRINT USING lets you format your output in many ways: 

• Numeric variable digits can be placed exactly where you want them. 

• You can insert a decimal point in dollar amounts. 

• You can place a dollar sign ($) immediately in front of the first digit of a dollar 
amount. 

• You can print a dollar sign ahead of an amount. 

• Amounts can be padded to the left with asterisks (***$45.00) for check protec¬ 
tion purposes. 

• Numbers can be forced into exponential (E) or double-precision (D) format. 

• A plus sign ( + ) causes output to print as a + for positive and a - for negative 
numbers. 

PRINT USING # 

The pound sign # holds a position for each digit in a number. Digits can be specified to 
the right or left of the decimal point with the pound sign #. Zeros are inserted to the 
right of the decimal, if needed, in the case where the amount is in whole dollars. 
Decimal points are automatically lined up when # is used. The# is convenient in finan¬ 
cial programming. 

Example Program: 

10 X = 246 

20 PRINT USING "###";X 

RUN iHg 

246 

If a number has more digits than the number of pound signs, then a percent sign will 
print in front of the number. 
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Example Program: 


100 X = 99999 110 PRINT USINC "###";X 
120 END 


%99999 


PRINT USING . 


Place the period anywhere within the # decimal place holders. The decimal in the 
amount will align with the decimal in the USING specification. 

10 X = 2.468 20 PRINT USING "##.##";X 

RUN 


Note that since only two digits were specified after the decimal point, the cents Posi¬ 
tion was rounded up. 

PRINT USING , 

Place a comma in any PRINT USING digit position. The comma symbol causes a com- 
ma to print to the left of every third digit in the result. Extra decimal position holders (#) 
must be used if more than one comma is expected in a result. 

Example Program: 

10 X# = 2933604.53 ! Double precision needed this # tag 
20 PRINT USING "########, .##";X# 

30 END 


2,933,604.53 

PRINT USING ** 

Two asterisks in the first two positions fill unused spaces in the result with asterisks. 
The two asterisks count as two additional digit positions. 

Example Program: 

100 X = 259 

120 PRINT USINC "**#######.##";X 


*259.00 
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PRINT US1NG $ 


A dollar sign at the starting digit position causes a dollar sign to print at the left digit 
Position in the result. 

Example Program: 

100 X= 3.59631 

110 PRINT USING "$###.##";X 
120 END 


run Cfguan 

$ 3.60 

PRINT USING $$ 

Two dollar signs ($$) in the first two positions give a floating dollar sign in the result. 
That is, the dollar sign will be located immediately next to the first decimal digit that is 
displayed. 

Example Program: 

100 X = 3.5961 

110 PRINT USING "$$###.##";X 
120 END 

RUN SHm 

$3.60 

PRINT USING **$ 

If **$ is used in the first three positions the result will have asterisks filling unused posi¬ 
tions and a dollar sign will float to the position immediately in front of the first 
displayed digit. 

Example Program: 

100 X= 53.29 

110 PRINT USING "**$########.##";X 
120 END 


run mmm 

********<£1^ 29 

PRINT USING AAAA 

Four exponentiation Symbols after the pound sign (#) decimal place holder will cause 
the result to be in exponential (E or D) form. 
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Example Program: 

100 X = 500 

110 PRINT USINC "##AAAA";X 
120 END 

run mm 

5E + 02 

PRINT USING + 

The plus sign ( + ) prints a + for positive and a minus (-) for negative in front of a 
number. The plus sign ( + ) can be used at the beginning or end of the PRINT 
USING String. 

Example Program: 

100 A = 999.55 

110 PRINT USINC " + ####";A 
120 END 

RUN Hussa 

+ 1000 

PRINT USING - 

The minus (-) sign following the PRINT USINC string makes a — appear following a 
negative number. A trailing space will appear if the number is positive. 

Example Program: 

100 A = -998 

110 PRINT USING "###-";A 
120 END 

run gamsn 

998- 

PRINT USING ! 

The exclamation sign (!) pulls the first character out of a string. 

Example Program: 

100 A$ = "B MATHEMATICS 1A" 

110 PRINT USINC "!";A$ 

120 END 

run fnnm 

B 
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PRINT USING %bbbb% 


INPUT 


LINE INPUT 


DATA 


The percent signs (%) and blank spaces (b) will pull part of a string out of a longer str- 
ing. The length of the string you pull out is 2 plus the number of spaces (b's) between 
the percent signs. 

Example Program: 

100 A$ = "Smith Fred" 

120 PRINT USING "%bbb%";A$ 

130 END 


RUN 


Smith 


Format: INPUT|#iocb| |"prompt_string"|, |AT(s,b)|; variable_name, (variable_name| 

INPUT#6 ("prompt_string"), |AT(x,y)|; variable_name 

Examples: 120 INPUT "TYPE YOUR NAME";A$ 

350 INPUT "ACCOUNT NO., NAME";NUM,B$ 

300 INPUT#5, AT(9,7);X 

INPUT lets you communicate with a program by typing on the Computer keyboard. 
You are also allowed to print character strings with the INPUT Statement. This lets you 
write prompts for the user such as TYPE YOUR NAME. The typed characters are as- 
signed to the variable names when you press the ffiBtHI key or type a comma. The IN¬ 
PUT Statement temporarily stops the the program until keyboard INPUT is complete. 
The INPUT Statement automatically puts a question mark on the television screen. 

If a disk drive has been opened as INPUT and assigned an IOCES#, then it can be used 
to input data. The input from the device is read AT(sector,byte) and assigned a variable 
name. INPUT#6, AT(x,y);X can be used to read a specific screen 
location. 


Format: LINE INPUT|#iocb| |"prompt_string") string_variable_name$ 

Example: 190 LINE INPUT ANS$ 


An entire line is input from the keyboard. Commas, colons, semicolons, and other 
delimiters in the line input from the keyboard are ignored. Mark the end of the line by 
Pressing ISO or its ASCI1 äquivalent &9B for the End of Line (EOL). 

Example Program: 

100 LINE INPUT "WHAT IS YOUR NAME?"; N$ 

120 PRINT N$ 

130 END 


Format: DATA arithmetic_constant,|arithmetic_constant| 

DATA string_constant, |string_constant| 

Example: 140 DATA 55,793,666,94.7,55 

150 DATA ACCOUNT,ACE,"""NAME""",SOCIAL SECURITY 
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The arithmetic__constants and string _ constants in the DATA Statement are assigned 

to variable names by the READ Statement. Use a comma to separate the entries that 
you wish to input with DATA/READ. More than one DATA Statement can be used. The 
first DATA item is assigned the first variable name encountered in READ; the second 
DATA item is assigned the second variable name, etc. When all the items are read and 
the program tries to read data when none exists — an "out-of- data" error occurs. The 
ERR statement can be used to test for the out-of-data condition. 

If a comma is included in a string item in a data statement, then the whole string item 
must be enclosed in quotes. Otherwise, it could be mistaken as a comma used to 
separate items in the DATA statement. Quotes are not required if a string uses numeric 
values as string data. 


READ Format: READ variable_name_Invariable_name_2,(|variable_name_etc.| 

Example: 150 READ A,B 

READ assigns numbers or Strings in the DATA statement to variable names in the 
READ statement. Commas separate variable names in the READ statement and items 
in the data statement. Hence, it is all right to leave extra spaces between items because 
the comma determines the end of items. READ A, B, C looks at the first three DATA 
items. If READ A, B, C is executed again, the next three numbers of the data statement 
are assigned to A, B, C respectively. The pairing of variables and data continues until 
all the data is read. 

Example of DATA/READ: 

100 FOR J = 1 TO 3 
120 READ A$,A 
130 PRINT A$,A 
140 NEXT J 

150 DATA FRED,50,JACK,20,JANE,200 
900 PRINT "END OF DATA" 

910 END 


RE STORE Format: RESTORE 1 1 ine_number) 

Examples: 440 RESTORE 770 
550 RESTORE 

The RESTORE statement is used if data items are to be used again in a program. That 
is, RESTORE allows use of the same DATA repeated a number of times. Without the 
RESTORE statement an out-of-data error results from the attempt to READ data a se¬ 
cond time. The data can be restored starting with a particular line number using the op¬ 
tional 11 ine_number|. 


AT Formats: PRINT#6, AT(x,y);variable_name,"string_constant" 

PRINT AT(x,yJ;variable_name,"string__constant" 

PRINT#iocb, AT(s,b);variable_name,"string_constant" 

INPUT#iocb, AT(s,b);variable_name 

AT can be added to either PRINT or INPUT. The numbers following AT refer to sector, 
byte if the proper disk #iocb has been opened. (See OPEN statement below.) The televi- 
sion screen is the output device when PRINT, or PRINT#6, are encountered. When the 
screen is the device, AT(x,y) gives the Coordinates for printing. 
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Format: OPEN #iocb, "device:program_name" file_access 

Examples: 130 OPEN #4, "K:" IN PUT 
100 OPEN #3, "P:" OUTPUT 
150 OPEN #4, "D:PROG.SAV" INPUT 
120 OPEN #2, "D.GRAPH1 BAS" UPDATE 
110 OPEN #5, "D:PROG.BAS" APPEND 


# Mandatory character entered by user. 

#iocb, Input/output control block (ICOB). Choose a number 

from 1 to 7 to identity a file and its file access. You must 
have a pound sign (#) followed by an IOCB number (1-7) 
and a comma. 

"device:program_name" Specifies the device and the name of the program. 

Devices are D: (disk), P: (printer), E: (screen editor), K: 
(keyboard), C: (cassette), S: (television monitor), and R: (RS- 
232-C). When you use D: your program name follows the 
colon. The name of your program can be up to eight 
characters long and have a three-character extension. Pro¬ 
gram names must begin with an alphabetic character. At 
the beginning of this section you will find a complete 
description of the device Codes (K:, P:, C:, D:, E:, 5:, R:). 

file_access Teils the type of Operation: 

IN PUT = inpiit Operation 

OUTPUT = output Operation 

UPDATE = input and output Operation 

APPEND = allows you to add onto the end of a file. 


The idea behind the OPEN Statement is to identify a number (the IOCB#) with the file 
access characteristics. After the OPEN#n Statement is encountered in a program, you 
can use PRINT#2, INPUT#3, NOTE#5, STATUS#2, GET#4, and PUT#4. That is, you can 
use the IOCB# as an identifier. 

The OPEN#n and PRINT#n Statements now Substitute for LPRINT (LINE PRINTING): 

100 OPEN#3, " OUTPUT 

110 PRINT#3, "THIS IS A PRINTER TEST" 

120 CLOSE#3 

The following IOCB# identifiers have preassigned uses: 

• #0 is used for INPUT and OUTPUT to E:, the screen editor. 

• #6 is used for INPUT and OUTPUT to S:, the screen itself, in test modes 
GRAPHICS 1 and GRAPHICS 2. 


An example of the use of IOCB #6 is: 

100 GRAPHICS 2 

110 PRINT#6, AT(5,5); "SCREEN PRINT TEST" 
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CLOSE 


NOTE 


PUT/GET 


STATUS 


lOCBs #1 through #5 (and IOCB #7) can be used freely, but the preassigned lOCBs 
should be avoided unless a program does not use them for one of the preassigned uses 
mentioned above. 


Format: CLOSE #iocb 
Example: CLOSE #2 

Use CLOSE after file operations are completed. The # sign is mandatory and the 
number itself identifies the IOCB. 

# Mandatory symbol 

icob The number of a previously opened IOCB 


Format: NOTE#iocb,variable_name, |variable_name| 

Example: 120 NOTE#4, l,J 

Use NOTE to störe the current diskette sector number in the first variable_name and 

the current byte number within byte. This is the current read or write position in the 
specified file where the next byte to be read or written is located. 


Formats: PUT#iocb, |AT(sector,byte);| arithmetic_expression 

GET#iocb, |AT(sector,byte);| variable_name 

Examples: 100 PUT#6, ASC("A") 

200 GET#1, X 

330 GET#3, AT(8,2);J,K,L 

PUT and GET are opposites. PUT Outputs a single byte value from 0-255 to the file 
specified by #/ocb (# is a mandatory character in both of these commands). GET reads 
1-byte values from 0-255 (using #iocb to designate the file, etc. on diskette or 
elsewhere) and then Stores the byte in the variable arithmetic_expression. 


Formats: STATUS (iocb_number) 

STATUS ("device:program_name") 

Examples: 100 A= STATUS (6) 

120 A = STATUS ("D:MICROBE.BAS") 

STATUS returns the value of the fourth byte of the iocb block (status byte). The Most 
Significant Bit (MSB) is a 1 for error conditions. A zero in the MSB indicates nonerror 
conditions. The remaining bits represent an error number. 
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TAB LE 7-1 

LIST OF STATUS CODES 


Hex 

Dec 

Meaning 

01 

001 

Operation complete (no errors) 

03 

003 

End of file (EOF) 

80 

128 

9535398 key abort 

81 

129 

IOCB already in use (OPEN) 

82 

130 

Nonexistent device 

83 

131 

Opened for write only 

84 

132 

Invalid command 

85 

133 

Device or file not open 

86 

134 

Invalid IOCB number (Y register only) 

87 

135 

Opened for read only 

88 

136 

End of file (EOF) encountered 

89 

137 

Truncated record 

8A 

138 

Device timeout (doesn't respond) 

8B 

139 

Device NAK 

8C 

140 

Serial bus input framing error 

8D 

141 

Cursor out of ränge 

8E 

142 

Serial bus data frame overrun error 

8F 

143 

Serial bus data frame checksum error 

90 

144 

Device-done error 

91 

145 

Bad screen mode 

92 

146 

Function not supported by handler 

93 

147 

Insufficient memory for screen mode 

A0 

160 

Disk drive number error 

AI 

161 

Too many open disk files 

A 2 

162 

Disk full 

A3 

163 

Fatal disk I/O error 

A4 

164 

Internal file number mismatch 

A5 

165 

Filename error 

A6 

166 

Point data length error 

A7 

167 

File locked 

A8 

168 

Command invalid for disk 

A9 

169 

Directory full (64 files) 

AA 

170 

File not found 

AB 

171 

Point invalid 


EOF Format: EOF(n) 

Example: 120 IF EOF(4) = 0 THEN GOTO 60 

A value of true or false will be returned indicating the detection of an end-of-file condi¬ 
tion on the last read of IOCB n. 
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ABOUT ARRAYS 


DIM 


ARRAYS 


You are allowed up to 10 subscripted elements in a list or array without having to use 
the dimension (DIM) Statement. 

For example: 

100 AN_ARRAY(1) = 55 

120 AN_ARRAY(2) = 77 

130 AN_ARRAY(3)= 93 

140 AN_ARRAY(4)= 61 

150 FOR X = 1 TO 4 

160 PRINT AN_ARRAY(X) 

170 NEXT 
180 END 


An array with more than 10 elements must be dimensioned to reserve space for it in 
RAM. 


Formats: DIM arithmetic_variable_name (number_of_elements), |list| 

DIM string_variable_name$ (number_of_elements), |list| 

Example: 10 DIM A$ (35), TOTAMT (50) 

The DIM Statement teils the Computer the number of elements you plan to have in an 
array. If you enter more data elements into an array than you have allowed for in a 
dimension Statement, you will get an error message. 

The simplest array is the one-dimensional array. Let's say a teacher has 26 students in a 
dass. He can record a numeric test score for each Student by dimensioning: 

10 OPTION BASE 1 
20 DIM SCORE(26) 

30 SCORE (1) = 55 
40 SCORE (2) =86 
50 PRINT SCORE (1), SCORE (2) 

RUN 


Notice that the OPTION BASE Statement begins the array subscripting with 1, thus 
SCORE (1) Stores the numeric score of the first Student. OPTION BASE 0 will allow you 
to begin subscripting with the number 0. 
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ATARI Microsoft BASIC allows you to have up to 255 array dimensions. Three- 
dimensional arrays allow you to make complex calculations easily. 

Example Program: 


110 X = 20:Y = 30:Z = 25 
120 DIM BOXES(X,Y,Z) 

130 IWithout an OPTION (0/1) the OPTION BASE defaults to 0 
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FUNCTION LIBRARY 


ABS Format: ABS (expression) 

Example: ABS (-7) 

ABS returns the absolute value of a number. The sign of a number will always be 
positive after this function is executed. If the number-7 (negative 7) is evaluated with 
ABS, the result will be 7 (positive 7). 

INT Format: INT (arithmetic expression) 

Examples: ? INT (5.3) prints 5 on your television screen 

? INT (-7.6) prints -8 on your television screen 


INT returns an integer for the arithmetic _ expression. INT always rounds to the 

next lower integer. 

SGN Format: SGN (arithmetic expression) 

Example: ? SGN (-34) prints -1 on your television screen 

SGN returns the sign of the arithmetic _ expression enclosed in parentheses. The sign is 

+ 1 if the number within the parentheses is positive, 0 if the number is 0, or-1 if the 
number is negative. 

SQR Format: SQR (arithmetic expression) 

Example: ? SQR (25) prints 5 on your television screen 

SQR returns the square root of a positive arithmetic__expression enclosed in paren¬ 
theses. If the arithmetic _ expression evaluated by SQR has a negative (-) sign, you will 

get an ILLEGAL QUANTITY ERROR. 

RND Formats: RND Returns a random single-precision value between 0 and 1. 

RND (0) Same as RND above. 

RND (integer) Returns an integer between 1 and the integer inclusive. 
Examples: ? RND Prints 6 random digits after decimal point, 

RND (37) Prints a number between and including 1 through 37. 

RND returns random numbers. RND and RND (0) return random numbers between but 
not including 0 and 1. RND (integer) returns a positive integer between and including 1 
and the (integer). 
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LOG 


Format: LOG (arithmetic_expression) 

Example: ? LOG (5) prints the natural logarithm 1.60944 

LOG returns the natural logarithm (LOG e ) of a nonnegative arithmetic _ expression in 

the parentheses. LOG (0) will give a FUNCTION CALL ERROR. LOG (1) is 
1.61385904E-10. 


EXP Format: EXP (arithmetic expression) 

Example: ? EXP (3) prints 20.0855 

EXP returns the Eulehs number (e) raised to the power of the arithmetic _ expression 

within the parentheses. 

SIN Format: SIN (arithmetic expression) 

Example: ? SIN (1) prints the sine of 1 as .841471 radian 

SIN returns the trigonometric sine of the arithmetic _ expression. 


COS Format: COS (arithmetic expression) 

Example: ? COS (.95) prints cosine of .95 as .581683 radian 

COS returns the trigonometric cosine of the arithmetic _ expression. 

ATN Format: ATN (arithmetic__expression) 

Example: ? ATN (.66) prints arctangent of .66 as .583373 radian 

ATN returns the arctangent of the arithmetic-expression. 


TAN Format: TAN (arithmetic_expression) 

Example: ? TAN (.22) prints the tangent of .22 as .223619 radian 

TAN returns the trigonometric tangent of the arithmetic _ expression. 


SPECIAL-PURPOSE FUNCTIONS 


PEEK Format: PEEK (address) 

Examples: 110 PRINT PEEK(1034) 
135 PRINT PEEK(ADDR) 


PEEK (&FFF) looks at the address enclosed in the parentheses, in this case FFF hex- 
adecimal. PEEK is used to discover the contents of a particular memory Byte. You can 
examine ROM memory as well as RAM memory. All memory can be looked at with the 
PEEK instruction. 
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Examples: 


POKE 


FRE (0) 


PRINT PEEK(888) 

Prints the byte in decimal at decimal memory location 888. 
PRINT PEEK (&FFFF) 

Prints the byte in decimal at memory location FFFF hex. 


Format: POKE address,byte 
Examples: POKE 2598,255 

110 POKE ADDR3,&FF 
120 POKE PEACE,J 

POKE inserts a byte into an address location. The address and byte can be expressed as 
decimal or hexadecimal numbers. The address and byte can also be expressions. Thus, 
if X*Y-2 evaluates to a valid memory location or byte, it can be used. 

Example: 

POKE &FFF,43 

Puts decimal 43 into hexadecimal location FFF. 

X = 22 
Y = &8F 

POKE X,Y 

Puts hexadecimal 8F into memory location 22 decimal. 

Note that decimal and hexadecimal are just two ways of assigning a number to the 
8-bit byte. The highest number you are allowed to POKE, a byte, is FF in hexadecimal 
and 255 in decimal. 


Format: FRE (0) 

Example: PRINT FRE(0) 

This function gives you the number of RAM bytes that are free and available for your 
use. Its primary use is in direct mode with a dummy variable (0) to inform the program- 
mer how much memory space remains for completion of a program. Of course FRE 
can also be used within a BASIC program in deferred mode. Using FRE (0) will release 
string memory locations that are not in use. This use of FRE (0) to pick up the string 
clutter is referred to as "garbage collection." 
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USR 


Format: USR (address,nl) 
Example: 550 A=USR(898,0) 


TIME 


USR passes the result of a machine language subroutine to a variable name. The USR 
function branches to a machine language routine address and can pass an optional 
value, nl. The value of nl is usually the address of a data table used in the machine 
language routine. 

Düring the execution of a USR routine, the programmer may use page zero RAM from 
&CD through &FF. The parameter passed will be stored in &E9 and &EA as data, and in 
&E3 and &E4 as an address. The parameter is assumed to be an integer or VARPTR. 

Example Program: 


10 ! ROUTINE TO TEST USR FUNCTION 
20 ! THE ASSEMBLY ROUTINE IS: 

30 ! 

40 ! LDA #35 
50 ! STA 710 
60 ! RTS 
70 ! 

80 ! 

90 ! 

100 A = 0:I=0:COL = 0:C = 0 
110 OPTION RESERVE 10 

120 ADDR = VARPTR(RESERVE) ISTARTING ADDRESS 

130 FOR 1=0 TO 5 

140 READ A 

150 POKE ADDR+ l,A 

160 NEXT I 

170 DATA &A9,&23,&8D,&C6,&02,&60 
180 A= USR(ADDR,VARPTR(I)) 

190 STOP 


Format: TIME 
Example: 200 PRINT TIME 

TIME gives the Real-Time Clock (RTCLOK) locations' contents. The decimal locations 
18,19, and 20 (RTCLOK) keep the system time in jiffies (1/60 of a second). Six decimal 
digits are returned by TIME. The difference between TIMES and TIME is that TIMES 
gives the time in Standard hours, minutes, and seconds, while TIME gives the time as a 
jiffie count. 
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+ 

(Concatenation 

Operator) 


MID$ 


LEFT$ 


STRINGS 


Format: String + String 
Example: 110 C$ = A$ + B$ 

Use the + Symbol to bring two strings together. 

Example Program: 

110 A$ = "never" 

120 B$ = "more" 

130 Z$ = A$+B$ 

140 PRINT Z$ 


RETURN 


nevermore 


Format: MID$(string_expression_$,Start,n) 

Example: 100 A$ = "GETTHEMIDDLE" 

110 PRINT MID(A$,4,3) 

string_expression _$ String that will have characters pulled from its middle. 

Start The character you wish to Start with — counting from the 

left. 

n Number of characters you want to pull. 


The string is identified by the first Parameter of the function. The second parameter 
teils the starting character. The third parameter teils how many characters you want. 

Example Program: 


110 A$ = "AMOUNT OF INTEREST PAID" 

120 B$ — MlD$(A$,11,8)! THIS CAUSES "INTEREST" TO BE PRINTED 
130 PRINT B$ 


Format: LEFT$(string_expression_$,n) 

Example: 100 A$ = "TOTALAMOUNT" 

110 PRINT LEFT$(A$,5) 

string_expression _$ String variable name or string expression. 

n Number of characters you want returned from the left 

side of the string. 
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RIGHTS 


LEN 


ASC 


VAL 


CHR$ 


Format: RIGHT$(string_expression_$,n) 

Example: A$ = "THERIGHT" 

110 PRINT RIGHT$(A$,5) 

string_expression__$ String variable name or string expression. 

n Number of characters to be taken from right side of the 

string. 


Format: LEN (string_expression._$) 

Example: 100 A$ = "COUNT THE" 

120 ? LEN (A$ + " CHARACTERS")!prints total number of 
130 ! characters as 20 

LEN returns the total number of characters in a string _ expression _ .$. LEN Stands for 

length. Spaces, numbers, and special Symbols count as characters. 


Format: ASC (string_expression_$) 

Example: ? ASC("Smith")!prints 83 ATASCII decimal code for letter S 

ASC gives the ATASCII code in decimal for the first character of the string enclosed in 
parentheses. See Appendix K for ATASCII Character Set. 


Format: VAL (numeric_string_expression_$) 

Example: 100 B$ = "309" 

120 ? VAL (B$)lprints the number 309 
130 END 

VAL converts Strings to numeric values. VAL returns the numeric value of the numeric 

constant associated with the numeric _ string _ expression in the parentheses. Leading 

and trailing spaces are ignored. Digits up to the first nonnumeric character will be con- 
verted. For example, PRINT VAL("123ABC") prints 123.1 f the first character of the string 
expression is nonnumeric, then the value returned will be 0 (zero). 


Format: CHR$ (ATASCII_code_number) 

Examples: 110 PRINT CHR$ (123) !prints ATASCII club Symbol 

100PRINT CHR$(65) IPRINTS ATASCII CHARACTER A 

CHR$ converts ATASCII values into one-character Strings. CHR$ is the opposite of the 
ASC function. The ATASCII _ code number can be any number from 0 to 255. Appen¬ 
dix K gives a table of both the character set and the ATASCII_code_numbers. 
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INSTR 


STR$ 


STRING$ (N,A$) 


STRING$ (N,M) 


INKEY$ 


Format: INSTR (start,A$,B$) 

Example: 110 HOLD = INSTR(5,C$,B$) 

INSTR searches for a small string B$ within a larger string A$. The search can begin 
(start) a number of characters into the larger string. This starting position is assumed to 
be the first character if start is missing. The function returns the character position 
within A$, where B$ Starts, or returns a 0 if B$ is not found. 


Format: STR$ (arithmetic_expression) 

Example: 100 A = 999.02 

110 PRINT STR$(A) 

STR$ turns an arithmetic _ expression into a string. String operations can be carried out 

on arithmetic _ expressions with the STR$ function. Note that when the following two 

strings are brought together with the concatenation symbol, there is a space between 
them which represents the sign of the number. 

Example Program: 

100 NUM1 =-22.344 
120 NMU2 = 43.2 

130 PRINT STRS (NUM1) + STR$ (NUM2) 

140 END 


Format: STRINGS (N,A$) 

Example: 100 AS = STRINCS(20,"*") 

STRING$(N,A$) returns a string composed of N repetitions of A$. 


Format: STRINGS (N,M) 

Example: 110 PRINT STRINCS(20,123)!prints 20 clubs 
STRING$(N,M) returns a string composed for N repetitions of CHRS(M). 


Format: INKEYS 
Example: 110 AS= INKEYS 

INKEYS records the last key pressed. If no keys are currently being pressed on the 
keyboard, a null string is recorded. Statement 110 tests for a null string by representing 
it as two double quotes with no space between them. ATARI Microsoft BASIC does not 
recognize the space bar since leading and trailing blanks are trimmed for INKEYS. 

Example Program: 

100 AS= INKEYS 

110 IF AS< >"" THEN PRINT "You typed a AS 
120 GOTO 100 
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TIME$ 


SCRN$ 


Format: TIMES 
Example: 100 PRINT TIMES 

Set the time with the deferred mode Statement: 


190 TIMES = "HH:MM:SS" 

where HH = hours (up to 24) 

MM = minutes 
SS = seconds 

Examples: 110 TIMES = "22:55:05" 

120 TIMES = "05:30:09" 

Note: Use leading zeros to ma.ke hours, minutes, and seconds into 2-digit numbers. 

After TIMES is set, you can use it in a program. TIMES is continually updated to the 
current time, from your initial setting. 

100 GRAPHICS 2 
110 TIMES = "11:59:05" 

120 PRINT#6, AT(3,3);"DIGITAL CLOCK" 

130 PRINT#6, AT(4,4);TIME$ 

140 GOTO 120 


Format: SCRN$(x,y) 

Example: 10 ? SCRN$(5,5) 

The character at the X-coordinate and Y-coordinate is returned as the value of the func- 
tion in character-graphics modes. In other graphics modes, SCRNS returns the color 
register number being used by the pixel at location x,y. 

Example of SCRN$(x,y): 

10 GRAPHICS 1 
20 COLOR 1 
30 PRINT#6, AT(5,5);"A" 

40 AS = SCRN$(5,5) 

50 PRINT TAB(9);A$ 

60 END 
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USER-DEFINED FUNCTION 


DEF Format: DEF function_name (variable,variable) = function_definition 

Example: 150 DEF MULT(J,K) = J*K 

User-defined functions in the form DEF A(X) = XA2, where A(X) represents the value of 
X, squared can be used throughout a program as if they were part of the BASIC 
language itself. Normally a user-defined function will be placed at the beginning of a 
program. The user-defined function can occupy no more than a single program line. 

String-defined functions are allowed. If the defined function is a string_variable_ 

name, then the defined expression must evaluate to a string result. One or more 
Parameters can be defined. Thus, DEF S$(A$,B$) = A$+B$ is legal. 

Example Program: 

100 DEF AVG(X,Y) = (X + Y)/2 
120 PRINT AVG(25,35) 

130 END 

run esut 

30 
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GRAPHICS 


GRAPHICS 

OVERVIEW 


GRAPHICS 


The GRAPHICS command selects one of nine graphics modes. Graphics modes are 
numbered 0 through 8. The arithmetic expression following GRAPHICS must evaluate 
to a positive integer. Graphics mode 0 is a full-screen text mode. ATARI Microsoft 
BASIC defaults to GRAPHICS 0. 

GRAPHICS 1 through 8 are split-screen modes. In the split-screen modes a 4-1 ine text 
window is at the bottom of the television screen. The text window is actually 4 lines of 
GRAPHICS 0 mixed into the mode. 

GRAPHICS 0, GRAPHICS 1, and GRAPHICS 2 display text and special characters of 
gradually increasing size. GRAPHICS 0 is regulär text with special characters. 
GRAPHICS 1 is double-wide text and special characters. GRAPHICS 2 is double-wide, 
double-high text, and special characters. Note the keyboard representation of the text 
and special characters as an insert to this manual. The special characters that are not 
printed on your keyboard are called control characters because you must press the 
IsSÜ key to have them display on the television screen. 

GRAPHICS 3 through GRAPHICS 8 are modes that plot points directly onto your 
television screen. The graphics mode dictates the size of the plot points and the 
number of playfield colors you can use. The maximum number of playfield colors in 
the point-plotting modes is four. But it is possible to get four more colors on your 
television screen by using players and missiles. For information on player-missile 
graphics, see Section 13. 


Format: GRAPHICS arithmetic_expression 

Examples: GRAPHICS 2 

100 GRAPHICS 5 + 16 
110 GRAPHICS 1 +32 + 16 
120 GRAPHICS 8 
130 GRAPHICS 0 
140 GRAPHICS 18 

Use GRAPHICS to select one of nine graphics modes (0 through 8). Table 12-2 sum- 
marizes the nine modes and characteristics of each. GRAPHICS 0 is a full-screen text 
display. Characters can be printed in GRAPHICS 0 by using the PRINT Statement 
without an IOCB# following the keyword PRINT. GRAPHICS 1 through GRAPHICS 8 
are split-screen modes. These split-screen modes actually mix four lines of GRAPHICS 
0 at the bottom of the television screen This text window uses the PRINT Statement. 
To print in the large graphics window in GRAPHICS 1 and GRAPHICS 2, use PR/NT#6, . 
The following program will print in the graphics window in GRAPHICS 1 or GRAPHICS 
2 : 


100 GRAPHICS 1 

110 PRINT#6, AT(3,3);"GRAPHICS WINDOW TEST" 
120 PRINT "TEXT WINDOW" 

130 END 
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COLOR 


Adding +16 to GRAPHICS 1 through GRAPHICS 8 will override the text window and 
make a full screen graphics mode. If you run the following program without line 140, 
the screen will return to graphics mode 0. The screen returns to graphics mode 0 when 
STOP or END terminate the full screen graphics mode. 


110 GRAPHICS 2 + 16 

120 PRINT#6, AT(3,3);"WHOLE SCREEN IS" 

130 PRINT#6, AT(4,4);"GRAPHICS 2" 

140 GOTO 140 

Normally the screen will be cleared of all previous graphics characters when a 
GRAPHICS n Statement is encountered. Adding +32 prevents the graphics command 
from Clearing the screen. 

Graphics modes 3 through 8 are point-plotting modes. To draw point graphics you 
need to use the COLOR n and PLOT Statements. Use of the SETCOLOR Statement will 
allow you to change the default colors to any one of 128 different color/luminance 
combinations. Point-plotting modes are explored in the example at the end of this sec- 
tion. 


To return to GRAPHICS 0 in direct mode, type GRAPHICS 0 and press the 


RETURN 


key. 


Format: COLOR n 
Example: 100 COLOR 4 

COLOR is paired with SETCOLOR to write up to four colors, called playfields, on the 
television screen. You must have a COLOR Statement in GRAPHICS 3, 4, 5, 6, 7, and 8 
in order to plot a color. When you use the COLOR Statement without a SETCOLOR 
command you will get the default colors. For example, using Table 12-1, the default 
colors for GRAPHICS 3 are: SETCOLOR 4 is orange, SETCOLOR 5 is light green, SET¬ 
COLOR 6 is dark blue, and SETCOLOR 8 is black. 

Shown below are the SETCOLOR - COLOR pairings by graphics mode: 

GRAPHICS 3, 5, 7 

SETCOLOR 4,hue,lum goes with COLOR 1 
SETCOLOR 5,hue,lum goes with COLOR 2 
SETCOLOR 6,hue,lum goes with COLOR 3 
SETCOLOR 8,hue,lum goes with COLOR 0 


GRAPHICS 4, 6 

SETCOLOR 4,hue,lum goes with COLOR 1 
SETCOLOR 8,hue,lum goes with COLOR 0 

GRAPHICS 8 

SETCOLOR 5,hue,lum goes with COLOR 1 
SETCOLOR 6,hue,lum goes with COLOR 2 

Note: You must always have a COLOR Statement to plot a playfield point, but SET¬ 
COLOR is only necessary to make a color other than a default color. 
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SETCOLOR 


Format: SETCOLOR register,hue,luminance 

Example: 330 SETCOLOR 5,4,10 


The SETCOLOR Statement associates a color and luminance with a register. 


register Color registers 0,1,2,3 are for player-missiles 0,1,2,3 

respectlvely. Color registers 4,5,6,7 are for playfield colors 
assignments. Register 8 is always the background register. 

hue Color hue number 0-15. (See table below.) 

luminance Color luminance (must be an even number betweenO and 

14; the higher the number, the brighter the display; 14 is 
almost pure white). 


TABLE 12-1 

THE ATARI HUE (SETCOLOR COMMAND) NUMBERS AND COLORS 


Colors 

SETCOLOR Hue 
Number Decimal 

SETCOLOR Hue 
Number Hex 

Gray 

0 

0 

Light orange (gold) 

1 

1 

Orange 

2 

2 

Red-orange 

3 

3 

Pink 

4 

4 

Purple 

5 

5 

Purple-blue 

6 

6 

Azure blue 

7 

7 

Sky blue 

8 

8 

Light blue 

9 

9 

Turquoise 

10 

A 

Green-blue 

11 

B 

Green 

12 

C 

Yellow-green 

13 

D 

Orange-green 

14 

E 

Light orange 

15 

F 
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PLOT 


Formats: PLOT X,Y 

PLOT X,Y TO PLOT X,Y 
Examples: 100 PLOT 12,9 

112 PLOT 6,9 TO 3,3 

Use PLOT to draw single-point plots, lines, and outline objects on the television screen. 
PLOT uses an X-Y coordinate System for specifying individual plot points. Cive a 
number from 0 to whatever the maximum is for the current mode, X first then Y. 

o,o ,-► x 


t 

Y 

You can "chain" the PLOT instruction. That is, one plot point can be made to draw to 
the next plot point. The result of chaining two PLOT points is a straight line. It is also 
easy to outline an object using chained plots. To chain plots, use the word TO between 
PLOT X,Y's. 

Example: 90 COLOR 1 !You must use a COLOR instruction before PLOT 
100 PLOT 5,5 TO 5,15 IDraws a straight line 
120 PLOT 5,5 TO 12,12 TO 2,12 TO 5,5 IDraws triangle outline 


Here is an example program which shows PLOT, COLOR, and SETCOLOR at work: 

100 GRAPHICS 3 + 16 ITHE 16 CETS RID OF TEXT WINDOW 
110 SETCOLOR 5,4,8 IPINK 
120 SETCOLOR 6,0,4 IG RAY 
130 SETCOLOR 8,8,6 IBLUE 

140 COLOR 1 ICOLOR 1 GOES WITH DEFAULT ORANGE 

150 PLOT 5,5 TO 10,5 TO 10,10 TO 5,10 TO 5,5 IIN ORANGE 

160 COLOR 2 I PINK 

170 PLOT 7,7 TO 12,12 TO 2,12 TO 7,7 

180 COLOR 3 IG RAY 

190 PLOT 2,7 TO 12,7 

200 GOTO 200 


FILL Format: FILL x,y TO x,y 

Example: 550 FILL 10,10 TO 5,5 

FILL fills an area with the color specified by the COLOR and SETCOLOR Statements. 
The FILL process sweeps across the television screen from left to right. FILL stops paint- 
ing and Starts its next sweep when it bumps into a PLOT line or point The line on the 
left-hand side of a filled object is specified by the FILL Statement itself. 

An example will show how FILL operates. First the outline of three sides of a box are 
specified. PLOT 5,5 TO 20,5 TO 20,20 TO 5,20 makes the top, right side, and bottom of 
the box. Make the left side and FILL with the Statement FILL 5,5 TO 5,20. 
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Example: 


5,5 


5, 20 



20 , 


20 , 


5 


20 


The top, right, and bottom of the box (dashed lines) is formed with PLOT 5,5 TO 20,5 
TO 20,20 TO 5,20. The box is filled with the Statement FILL 5,5 TO 5,20. 

10 GRAPHICS 5 

20 SETCOLOR 4,12,8 .'Register 4, green, medium brightness 
30 COLOR 1 ICOLOR 1 is paired with SETCOLOR 4 in GRAPHICS 5 
40 PLOT 5,5 TO 20,5 TO 20,20 TO 5,20 
50 FILL 5,5 TO 5,20 
60 END 


It is worthwhile to carefully review the FILL process. Line 40 in the above example 
makes three sides of a box. Then the FILL Statement, line 50 draws the left side and fills 
the box. The FILL process scans from the FILL line to the right until it reaches the PLOT 
lines. 


CLS Format: CLS |background register option| 

Example: CLS 

110 CLS 

220 GRAPHICS 3: CLS &C5 
330 CLS 25 

CLS clears screen text areas and sets the background color register to the indicated 
value, if present. In GRAPHICS 0 and GRAPHICS 8 the optional number after CLS 
determines the border color and luminance. In GRAPHICS 1, 2, 3, 4, 5,6, 7 the optional 
number following CLS determines the background color and luminance. 


TAB LE 12-2 

GRAPHICS MODES AND SCREEN FORMATS 


Graphics 

Mode 

Mode 

Type 

Columns 

ROWS- 

Split 

Screen 

ROWS- 

Full 

Screen 

Number 

of 

Colors 

RAM 

Required 

(Bytes) 

0 

TEXT 

40 

- 

24 

2 

992 

1 

TEXT 

20 

20 

24 

5 

674 

2 

TEXT 

20 

10 

12 

5 

424 

3 

GRAPHICS 

40 

20 

24 

4 

434 

4 

GRAPHICS 

80 

40 

48 

2 

694 

5 

GRAPHICS 

80 

40 

48 

4 

1174 

6 

GRAPHICS 

160 

80 

96 

2 

2174 

7 

GRAPHICS 

160 

80 

96 

4 

4198 

8 

GRAPHICS 

320 

160 

192 

y 2 

8112 
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TABLE 12-3 

CHARACTERS IN GRAPHICS MODE 1 AND 2 


POKE 

756,224 

POKE 

756,226 

SETCOLOR 

4 

SETCOLOR 

5 

SETCOLOR 

6 

SETCOLOR 

7 


□ 

32 

0 

160 

128 

n 

13 

33 

1 

161 

129 

D 

D 

34 

2 

162 

130 

D 

□ 

35 

3 

163 

131 

□ 

CI 

36 

4 

164 

132 

□ 

□ 

37 

5 

165 

133 

□ 

Q 

38 

6 

166 

134 

B 

□ 

39 

7 

167 

135 

D 

E 

40 

8 

168 

136 

D 

D 

41 

9 

169 

137 

B 

CS 

42 

10 

170 

138 

B 

Ei 

43 

11 

171 

139 

B 

B 

44 

12 

172 

140 

B 

B 

45 

13 

173 

141 

fl 

a 

46 

14 

174 

142 

B 

n 

47 

15 

175 

143 

B 

□ 

48 

16 

176 

144 

B 

□ 

49 

17 

177 

145 

B 

□ 

50 

18 

178 

146 

B 

□ 

51 

19 

179 

147 

B 

□ 

52 

20 

180 

148 

B 

□ 

53 

21 

181 

149 

B 

ii 

54 

22 

182 

150 

B 

□ 

55 

23 

183 

151 

B 

□ 

56 

24 

184 

152 

B 

ii 

57 

25 

185 

153 

B 

□ 

58 

26 

186 

154 

B 

□ 

59 

27 

187 

155 

B 

B 

60 

28 

188 

156 

B 

B 

61 

29 

189 

167 

B 

B 

62 

30 

190 

168 
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ssz 

£ZZ 

ZZL 

S6 

□ B 

vsz 

zzz 

92 L 

^6 

□ □ 

£S2 

IZZ 

SZL 

£6 

Q fl 

2 sz 

ozz 

WY 

26 

□ B 

LS2 

6L2 

£ZY 

L6 

□ B 

osz 

9L2 

ZZL 

06 

B B 

6W 

LYZ 

YZY 

69 

q b 

QW 

9YZ 

02 L 

99 

g fl 

LW 

S IZ 

611 

Z9 

□ □ 

9W 

H2 

9LL 

99 

B B 

WZ 

£IZ 

LYY 

S9 

□ B 

WZ 

ZIZ 

9LL 

W 

B B 

WZ 

HZ 

SLL 

£9 

B B 

ZW 

OYZ 

HL 

29 

B B 

IW 

602 

£YY 

L9 

B B 

ow 

902 

ZYY 

09 

B B 

6£2 

Z02 

YYY 

6 Z 

fl fl 

9£2 

902 

OLL 

9Z 

B fl 

L£Z 

SOZ 

60 L 

ZZ 

B B 

9£2 

WZ 

90 L 

9 Z 

B B 

S£2 

eo2 

ZOL 

SZ 

B b 

WZ 

202 

90 L 

•vL 

B fl 

££Z 

LOZ 

SOL 

£L 

B B 

Z£Z 

002 

WY 

ZL 

fl B 

L£2 

66 L 

eoL 

LZ 

B fl 

0£Z 

96 L 

20 L 

OZ 

B B 

6ZZ 

Z6L 

LOL 

69 

B B 

922 

96 L 

00 L 

99 

fl □ 

LZZ 

S6L 

66 

Z9 

B fl 

9ZZ 

V6Y 

96 

99 

fl fl 

szz 

m 

Z6 

S9 

B fl 

nz 

261 

96 

V9 

a 


69 1 

161 

ie 

69 

D 

□ 





POINT- 

PLOTTINC 

MODES 


The following short program demonstrates and confirms Table 12-3. This program 

prints the ATASCII code for a character in the text window and the character itself in 
the graphics window. Every time you press the key, a new character appears. 

The reason SETCOLOR 4,0,0 is the same as SETCOLOR 8,0,0 is to avoid a screen filled 
with hearts. Another way to accomplish this is to lower the character set into RAM (us- 
ing MOVE) and redefine the heart character as 8 by 8 zeros. See Appendix C, Alternate 

Character Sets, for an example of lowering and redefining the character set. The 
special character set is shown in the program as it is now written. To see the Standard 
character set, just delete line 20. The GRAPHICS 2 instruction automatically pokes 
756,224. 


10 GRAPHICS 2 
20 POKE 756,226 
30 SETCOLOR 8,0,0 

40 SETCOLOR 4,0,0!AVOID SCREEN HEARTS 

50 SETCOLOR 5,4,6!PINK 

60 SETCOLOR 6,12,2!CREEN + TEXT WINDOW 

70 SETCOLOR 7,9,6!LICHT BLUE 

80 A$= INKEYS 

90 IF A$ = "" THEN 80 

100 ON ERROR GOTO 150 

110 PRINT #6, AT(6,6);CHR$(X) 

120 PRINT X 
130 X = X + 1 
140 GOTO 80 

150 RUN IREPEATS WHEN 256 REACHED 


GRAPHICS 3 through 8 plot individual points on your television screen. The number 
following GRAPHICS determines the size of the points you plot. GRAPHICS 3 has the 
largest plot points. The following program can be used in GRAPHICS 3 through 8 by 
changing line number 10 to the appropriate graphics number. Note that you must in- 
clude line 20 since it indicates that you are using COLOR1 as a default (see Table 12-4 
for default colors). 


10 GRAPHICS 3 ICAN BE GRAPHICS 3 THROUGH 8 
20 COLOR 1 IYOU WANT DEFAULT COLOR - ORANGE 
30 PRINT "TYPE TWO NUMBERS - SEPARATE THE TWO' 
40 PRINT "NUMBERS WITH A COMMA" 

50 PRINT "PLOT X,Y" 

60 INPUT X,Y 
70 PLOT X,Y 
80 GOTO 30 


If you enter and run the above program you will see plot point 5,5 by typing 5,5 and 
pressing the t* j%2f key. The boundaries and middle of GRAPHICS 3 are as follows. 
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39, 0 


39,19 


If you insert a new Statement — Statement 15 — 15 SETCOLOR 4,4,8 you will get 
large, pink dots instead of the default orange. This change to the original plotting pro¬ 
gram gives you pink plot points because SETCOLOR 4,x,x aligns with COLOR 1 in 
GRAPHICS 3. You can also make the text window at the bottom of the screen go away 
by changing Statement 10 to 10 GRAPHICS 3 + 16. 


TABLE 124 

DEFAULT COLORS, MODE, SETCOLOR, AND COLOR 


Default 

Mode or 

Setcolor 

Color 

Description 

Colors 

Condition 

Register 

n 

and Comments 


GRAPHICS 0 

4 

Register 


Light blue 


5 

holds 

Character luminance 

Dark blue 


6 

character 

(same as background) 



7 


Character 

Black 

Text Mode 

8 

Border 


Orange 


4 


Character 

Light green 

GRAPHICS 1,2 

5 


Character 

Dark blue 


6 


Character 

Red 


7 


Character 

Black 

Text Modes 

8 


Character 

Background, border 

Orange 


4 

1 

Graphics point 

Light green 

GRAPHICS 3,5,7 

5 

2 

Graphics point 

Dark blue 


6 

7 

8 

3 

Graphics point 

Black 

4-color modes 

0 

Background, border 

Orange 

GRAPHICS 

4 

1 

Graphics point 


4 and 6 

5 

6 

" 

— 

Black 

2-color modes 

7 

8 

0 

Background, border 


GRAPHICS 8 

4 

- 

_ 

Light blue 


5 

1 

— 

Dark blue 


6 

7 

8 

2 

— 

Black 

1 color,2 lums. 

- 

Border 
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Note: Player-missile graphics color is SETCOLOR register, color, luminance, where 
register=0,1,2,3 and determines color of player-missile 0,1,2,3, respectively. Player¬ 
missile graphics will work in all graphics modes. 


The following programs will work in GRAPHICS 1 or GRAPHICS 2. The programs show 
the alternate basic character set and special character set (POKE 756,226). To restart 
these two programs, press the ^77 l ' key and type RUN followed by 


2 REM KEYBOARD TYPEWRITER 
10 GRAPHICS 2 

20 SETCOLOR 4,0,0!to avoid screen full of hearts in lowercase 
30 PRINT "TYPE Green/Blue/Red (G/B/R)" 

40 INPUT "AND PRESS RETURN? "; C$ 

50 IF C$ = "G" THEN K = 32 
60 IF C$ = "B" THEN K = 128 
70 IF C$ = "R" THEN K = 160 
80 PRINT "TYPE UPPER/LOWER (U/L)" 

90 INPUT "AND PRESS RETURN ? "; B$ 

100 IF B$ = "U" THEN 120 
110 POKE 756,226 

120 PRINT "NOW TYPE - ALPHA + CTRL KEYS" 

130 A$=INKEY$ 

140 IF A$ = "" THEN 130 

150 A = ASC(A$)+KI32 is green, 128 is blue, 160 is red 

160 PRINT A 

170 PRINT#6, CHR$(A); 

180 GOTO 130 


100 REM TWINKLE 
110 GRAPHICS 16+2 
120 X=RND(36) 

130 ON ERROR GOTO 150 
140 PRINT#6, TAB(X);"*" 
150 GRAPHICS 32 + 16+2 
160 RESUME 


PLAYERS AND 
MISSILES 


MAKING A 
PLAYER 

OUT OF PAPER 


13 

PLAYER-MISSILE GRAPHICS 


The following BASIC commands are tools to help you construct and move players and 
missiles: 

MOVE instruction 
OPTION (PLM1 or PLM2) 

VARPTR (PLM1 or PLM2) 

SETCOLOR 0 or 1 or 2 or 3 


Cut a Strip of paper about 2 inches wide from an 8 x 10 inch sheet of paper. Now draw 
an 8-bit-wide "byte" down the Strip of paper. 



Hex &08 drawn on 8-bit Strip. 
Hex &14 drawn on 8-bit Strip. 
Hex &22 drawn on 8-bit Strip. 
Hex &41 drawn on 8-bit Strip. 


An upside down V is shown on the Strip in binary and hex. This Strip of paper is like a 
player If you take the player strip and lay it vertically down the middle of the televi- 
sion screen, you have "positioned it with the horizontal Position register." When you 
move the strip right and left, you are "poking new locations into the horizontal position 
register" to get that movement. 

The MOVE instruction is used to move the player-missile object up and down the 
player-missile strip. Your paper strip can serve to demonstrate how the MOVE instruc¬ 
tion works. Let's say that you have put the upside down V on your paper strip with a 
pencil that has an eraser. To move the object it is necessary for you to erase the whole 
object and rewrite it elsewhere on the strip. 

As you can imagine, vertical movement is slightly slower than horizontal movement. It 
is slower because it takes only a single poke to the horizontal position register for 
horizontal movement, but many erasures and redrawings are necessary to move an ob¬ 
ject vertically. 

In the actual MOVE instruction you state the lowest address of the object you want to 
move; then state the lowest address of the new area to which you want to move the 
object; and lastly, state how many bytes you want moved. Hence the format: MOVE 
from_address, to_address, no_of_bytes. 
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HOW THE ATARI MICROSOFT BASIC INSTRUCTIONS ASSIST 
PLAYER-MISSILE GRAPHICS 


The OPTION (PLM1) zeros out and dedicates a single-line resolution player-missile 

area in RAM. OPTION (PLM2) is for double-line player-missile resolution. 

VARPTR(PLM1 or PLM2) points to the beginning memory location of the player-missile 
area in RAM. This is the point from which you must figure your offset or displacement 
to poke your image into the correct area. For example, the starting address (top of 
television screen) for player 0 in double-line resolution is VARPTR(PLM2) + 128. In 
double-line resolution each player is T28 bytes long. So if you wanted to poke astraight 
line in the middle of player 0, the poke would be POKE VARPTR[PLM2)-P192,&FF. 

The SETCOLOR instruction gives the register, color, and luminance assignments. In 
ATARI Microsoft BASIC the registers 0,1, 2, and 3 are used for player-missiles 0,1, 2, 
and 3. It is only necessary to specify SETCOLOR 0,5,10 to set player-missile 0; the CO¬ 
LOR instruction is not used. 

Remember that you must poke decimal location 559 with decimal 62 for single-line 
resolution or with decimal 46 for double-line resolution. You must also poke decimal 
location 53277 with decimal 3 to enable player-missile display. 

You can use player-missile graphics in all modes. Missiles consist of 2-bit-wide "strips." 
Missiles 0,1, 2, 3 are assigned the same colors as their associated player. Thus, when 
SETCOLOR sets the color of player 1 to red, it also sets missile 1 to red. 

The terms player and missile are derived from the animated graphics used in ATARI 
Video games. Player-missile binary tables reside in player-missile graphics RAM. This 
RAM accommodates four 8-bit players and four 2-bit missiles (see Figure 13-1). Each 
missile is associated with a player, unless you elect to combine all missiles to form a 
fifth, independent player (see "Priority Control"). 

A player, like the spaceship shown in Ligure 13-2, is displayed by mapping its binary 
table directly onto the television screen, on top of the playfield. The first byte in the 
table is mapped onto the top line of the screen, the second byte onto the second line, 
and so forth. Wherever 1's appear in the table, the screen pixels turn on; wherever 0's 
appear, the pixels remain off. The pattern of light and dark pixels creates the image. 

You can display player-missile graphics with single-line resolution (use OPTION(PLMI)) 
or double-line resolution (OPTION(PLM2)). If you select single-line resolution, each 
byte of the player will be displayed on a single scan line. If you choose double-line 
resolution, each byte will occupy two scan lines and the player will appear larger than 
in single-line resolution. Each player is 256 bytes long with single-line resolution, or128 
bytes long with double-line resolution. Line resolution only needs to be programmed 
once. The resolution you choose will apply to all player-missile graphics in your pro¬ 
gram. The Player-Missile Graphics Demonstration Program included in this section is 
an example of double-line resolution programming. 

Player-missile graphics give you considerable flexibility in programming animated 
video graphics. Registers are provided for player-missile color, size, horizontal position- 
ing, player-playfield priority, and collision control. 




GRAPHIC 

REPRESENTATION 
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REPRESENTATION 
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DECIMAL 

REPRESENTATION 

□ 


— 

□ 
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Figure 13-2 Mapping the Player 
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COLOR 

CONTROL 


SIZE CONTROL 


The ATARI 400 and ÄTARI 800 Computers have nine registers for user control of 

player-missile, playfield, and background color: 


TAB LE 13-1 

SETCOLOR REGISTER ASSIGNMENTS 


SETCOLOR Register,Color,Luminance Function 


SETCOLOR 0,color,luminance 
SETCOLOR 1,color,luminance 
SETCOLOR 2,color,luminance 
SETCOLOR 3,color,luminance 
SETCOLOR 4,color,luminance 
SETCOLOR 5,color,luminance 
SETCOLOR 6,color,luminance 
SETCOLOR 7,color,luminance 
SETCOLOR 8,color,luminance 


Color-Iuminance of Player-Missile 0 
Color-Iuminance of Player-Missile 1 
Color-Iuminance of Player-Missile 2 
Color-Iuminance of Player-Missile 3 
Color-Iuminance of Playfield 0 
Color-Iuminance of Playfield 1 
Color-Iuminance of Playfield 2 
Color-Iuminance of Playfield 3 
Color-Iuminance of background 


Players are completely independent of the playfield and of each other. Missiles share 
color registers with their players and hence are the same color as their players. If you 
combine missiles to form a fifth player, they assume the color of playfield color- 
luminance register 3 (COLPF3). 

To program color, specify the register, the hue, and the luminance. Use the SETCOLOR 
command. See lines 20 and 100 of the Player-Missile Graphics Demonstration Program 
for examples. See also "Graphics," Section 12. 

Each color-luminance register is independent. Therefore, you could use as many as 
nine different colors in a program, depending upon the graphics mode selected. All 
registers cannot be used in all graphics modes (see "Graphics," Section 12). 


Five size-control registers are provided —four for the players and one for all four 
missiles: 


TAB LE 13-2 

REGISTERS CONTROLLING WIDTH OF PLAYER-MISSILES 


Size 

Register 

Address 

Hex 

Dec 

Function 

SIZEP0 

D008 

53256 

Controls size of Player 0 

SIZEP1 

D009 

53257 

Controls size of Player 1 

SIZEP2 

D00A 

53258 

Controls size of Player 2 

SIZEP3 

D00B 

53259 

Controls size of Player 3 

SIZEM 

D00C 

53260 

Controls size of missiles 


Size-control registers allow you to double or quadruple the width of a player or missile 
without altering its bit resolution. To double the width, poke a 1 into the size register; 
to quadruple the width, poke a 3; and to return a player or missile to normal size, poke 
a 0 or 2. An example is given in line 80 of the Player-Missile Graphics Demonstration 
Program. 
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POSITION AND vertical 

MOVEMENT 

Vertical position is set when you specify the location of the player-missile in player- 

missile graphics RAM. The lower you place the player-missile in RAM, the higher the 
image will be on the television screen. A positioning technique is illustrated by lines 
120 and 200 of the Player-Missile Graphics Demonstration Program at the end of this 
section. 

To program vertical motion, use the MOVE command (see lines 350 and 390 of the 
Player-Missile Graphics Demonstration Program). Since the MOVE command does not 
zero the old location after the move, an extra zero at each end of the player is used to 
"cleanup" as the player is being moved. Give the current position of the player in 
RAM, the direction of the move through RAM (forward = +, backward = -), and the 
number of player bytes to be moved. Each byte of the player must be moved. Follow- 
ing the MOVE command, increment or decrement the vertical position counter (see 
lines 360 and 400 of the Player-Missile Graphics Demonstration Program). 


HORIZONTAL 

Each player and missile has its own horizontal position register, so players can move in- 
dependently of each other, and missiles can move independently of their players. 


TAB LE 13-3 

PLAYER-MISSILE HORIZONTAL POSITION REGISTERS 


Position Address 

Register Hex Dec Function 


H POS PO 

D000 

53248 

Horizontal position of Player 0 

H POS PI 

D001 

53249 

Horizontal position of Player 1 

HPOSP2 

D002 

53250 

Horizontal position of Player 2 

HPOSP3 

D003 

53251 

Horizontal position of Player 3 

HPOSMO 

D004 

53252 

Horizontal position of Missile 0 

HPOSM1 

D005 

53253 

Horizontal position of Missile 1 

HPOSM2 

D006 

53254 

Horizontal position of Missile 2 

HPOSM3 

D007 

53255 

Horizontal position of Missile 3 


To set the position of a player or missile, poke its horizontal position register with the 
number of the position. To program horizontal movement, simply change the number 
stored in the register. See lines 100 and 180 of the Player-Missile Graphics Demonstra¬ 
tion Program for examples. 

A horizontal position register can hold 256 positions, but some of these are off the left 
or right margin of the television screen. A conservative estimate of the ränge of player 
visibility is horizontal positions 60 through 200. The actual ränge will depend upon the 
television set. 


DIAGONAL 

Horizontal and vertical moves can be combined to move the player diagonally. Set the 
horizontal position first, then the vertical position. See lines 270 through 390 of the 
Player-Missile Graphics Demonstration Program. 
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PRIORITY 

CONTROL 


COLLISION 

CONTROL 


The Priority Control Register (PRIOR,&D01B; OS shadow CPRIOR.&26F) enables you 
to select player or playfield color register priority and to combine missiles to form a 

fifth player. 


PRIORITY SELECT 

You have the Option to specify which image will have priority in the event player and 
playfield images overlap. This feature enables you to make players disappear behind 
the playfield and vice versa. To set the priority, poke one of the following numbers into 
the Priority Control Register: 

1 — All players have priority over all playfields. 

2 — Players 0 and 1 have priority over all playfields, and all playfields have 

priority over players 2 and 3. 

4 = All playfields have priority over all players. 

8 — Playfields 0 and 1 have priority over all players, and all players have priority 
over playfields 2 and 3. 


ENABLE FIFTH PLAYER 


Setting bit D4 of the Priority Control Register causes all missiles to assume the color of 
Playfield Register 3 (&2C7, dec. 711). You can then combine the missiles to form a fifth 
player. If enabled, the fifth player must still be moved horizontally by changing all 
missile registers (&D004 through &D007) together. 


Collision control enables you to teil when a player or missile has collided with another 
graphics object. There are 16 collision control registers. 


TAB LE 134 

COLLISION CONTROL REGISTERS FOR PLAYER-MISSILES 


Collision 

Register 

Address 

Hex 

Dec 

Function 

MOPF 

D000 

53248 

Missile 0 to playfield 

Ml PF 

D001 

53249 

Missile 1 to playfield 

M2PF 

D002 

53250 

Missile 2 to playfield 

M3PF 

D003 

53251 

Missile 3 to playfield 

POPF 

D004 

53252 

Player 0 to playfield 

PI PF 

D005 

53253 

Player 1 to playfield 

P2PF 

D006 

53254 

Player 2 to playfield 

P3PF 

D007 

53255 

Player 3 to playfield 

MO PL 

D008 

53256 

Missile 0 to player 

Ml PL 

D009 

53257 

Missile 1 to player 

M2PL 

D00A 

53258 

Missile 2 to player 

M3PL 

D00B 

53259 

Missile 3 to player 

POPL 

D00C 

53260 

Player 0 to player 

PI PL 

D00D 

53261 

Player 1 to player 

P2PL 

D00E 

53262 

Player 2 to player 

P3PL 

DOOF 

53263 

Player 3 to player 
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In each case, only the rightmost 4 bits of each register are used. They are numbered 0, 
1, 2, and 3 from the right and designate, by position, which playfield or player the rele¬ 
vant player or missile has collided with. A one in any bit position indicates collision 
since the last HITCLR. 


CLEARING COLLISION REGISTERS 

All collision registers are cleared at once by writing a zero to the HITCLR register 
(&D01E, dec. 53278). 


PLAYER-MISSILE 
GRAPHICS 
DEMONSTRA¬ 
TION PROGRAM 


The following ATARI Microsoft BASIC program creates a player (spaceship) that 
shoots missiles and can be moved in all directions with the joystick. Connect a joystick 
Controller to CONNECTOR JACK 1 on the front of your ATARI Home Computer. 

05 !DOUBLE-LINE RESOLUTION PLAYER AND MISSILE 

10 GRAPHICS 8 

20 SETCOLOR 6,0,0 

30 X — 130 

40 Y = 70 

50 STICK0 = &278 

60 OPTION PLM2 

70 POKE 559,46 

80 POKE &D00C,1 

90 POKE &D01 D,3 

100 POKE &D000,X 

110 SETCOLOR 0,3,10 

120 FOR J = VARPTR(PLM2) + 128 + Y TO VARPTR(PLM2) + 135 +Y:READ A:POKE 
J,A 

125 NEXT J 

130 DATA 0,129,153,189,255,189,153,0 
140 IF PEEK(&D010) = 1 THEN 220 
150 SOUND 0,220,12,15,INT(X/30) 

160 ZAP = X 

170 POKE VARPTR(PLM2) + 4 + Y,3 
180 POKE &D004.ZAP 
190 ZAP = ZAP-12 

200 IF ZAP <12 THEN POKE VARPTR(PLM2) + 4 +Y,0:GOTO 220 ELSE 180 
210 IJOYSTICK MOVES 

220 A = PEEK(STICKO): IF A = 15 THEN GOTO 140 
230 IFA — 11 THEN X = X-1 
240 IF A = 7 THEN X = X+1 
250 POKE &D000,X 

260 IF A = 14 THEN GOTO 350 IMOVE UP 
270 IF A = 13 THEN GOTO 390 IMOVE DOWN 
280 IMOVE DIAGONALLY 

290 IF A —10 THEN X = X-1:POKE &DOOO,X:GOTO 350 
300 IF A = 6 THEN X = X + TPOKE &DOOO,X:COTO 350 
310 IF A = 9 THEN X = X-1:POKE &DOOO,X:COTO 390 
320 IF A = 5 THEN X = X + TPOKE &DOOO,X:GOTO 390 
330 GOTO 140 
340 IMOVE UP 

350 MOVE VARPTR(PLM2) + 128 + Y,VARPTR(PLM2) +128 + (Y-1),8 
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ANNOTATION 


360 Y = Y-1 
370 GOTO 140 
380 !MOVE DOWN 

390 MOVE VARPTR(PLM2)+128+(Y-1 ),VARPTR(PLM2)+128 + Y,8 

400 Y = Y + 1 

410 GOTO 140 

420 STOP 

430 END 


Line 

10 Sets a high-resolution graphics mode with no text window. You can pro¬ 

gram player-missile graphics in any graphics mode. See Section 12, 
"Graphics" and Table 1 2-4. 

20 Sets the background color to black, as follows: 

6 = Background Color-Luminance Register (COLBK, &DÜ1A); 

0 = Black (see Color Table 12-1); 

0 = Zero luminance. The luminance value is an even number be- 
tween 0 and 14. The higher the number, the greater the 
luminance and the brighter the color. 

30,40 Initializes player position variables X (horizontal) and Y (vertical). 

50 Assigns the label STICKO to joystick register 278. 

60 Specifies double-line resolution RAM for the player-missile graphics (see 

Figure 13-1). PLM1 would specify single-line resolution. 

70 Sets the Direct Memory Access Control Register (DMACTL, 559) for 

double-line resolution (46). A 62 would specify single-line resolution. 

Note When DMACTL is enabled, the player-missile graphics registers 
(GRAFP0-GRAFP3 and GRAFM) are automatically loaded with data 
from the player-missile RAM. 

80 Doubles the width of the missile by poking the Size Control Register 

(SIZEM, &D00C) with 1 Poking the register with a 3 would quadruple 
the width. 

90 Enables the Graphics Control Register (GRACTL, &D01D) to display 

player-missile graphics (3 enables, 0 disables). 

100 Pokes the horizontal position of the player (X = 130 from line 30) into 

the player 0 Horizontal Position Register (HPOSPO, &D000). 

110 Colors the player and missile bright red-orange as follows: 

0 = Player-missile 0 Color-Luminance Register (COLPMO, 
&D012); 

3 = Red-orange (see Color Table 12-1); 

10 = Luminance or brightness (see annotation of line 20). 
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120-125 

140 

150 


160 

170 

180 

190 

200 

220 

230/250 


Sets variable pointer VARPTR(PLM2) to the player-missile starting ad- 
dress in piayer-missile graphics RAM (see Figure 13-1), Pokes data 
from line 130 into the player area, VARPTR(PLM2)+128 +Y to 
VARPTR(PLM2)-P135+Y. The Computer uses the data in line 130 to 
map the spaceship onto the screen (see Figure 13-2). 

Teils the Computer to read the joystick 0 trigger register (TRIC0, 
&D010). If the trigger button is not activated (&D010 = 1), the Com¬ 
puter will go to line 220 and read the joystick position; if the button is 
activated (&D010 = 0), the Computer will execute lines 150 through 
200. 

Generates sound each time the joystick button is pressed. Sound is 
programmed as follows: 

(1) Select voice. As many as four voices (0 to 3) can be used, but 
each voice requires a separate SOUND Statement. 

(2) Choose pitch from Table 14-1. The larger the number, the lower 
the pitch. 

(3) Set distortion or noise level, using an even number between 0 
and 14. A 10 gives a pure tone; 12 gives a buzzer effect. 

(4) Set volume, an odd number between 1 and 15. The larger the 
number, the louder the sound. 

(5) Set duration of sound per second (20 = 20/60 or 1 A second). 

Sets the horizontal position of the missile (ZAP) equal to the horizon¬ 
tal position of the player (X). 

Turns on the screen pixels corresponding to the missile 0 RAM area 
[VARPTR(PLM2) + 4+Y] to display the missile (3 = ON; 0 = OFF). 

Pokes the horizontal position of the missile (ZAP = X from line 160) 
into the missile 0 horizontal position register (FIPOSMO, &D004). 

Decrements the missile 0 horizontal position counter by 12 to create 
a horizontal "line of fire" from the player. 

If the missile's horizontal position is less than 12 (off the left side of 
the screen), the Computer pokes 0's into the missile RAM area to clear 
it and goes to line 220. If the missile's horizontal position is 12 or 
greater, the Computer pokes the new hrizontal position into FIPOSMO 
(register &D004 in line 180) and decrements the horizontal position 
counter by 12 (line 190). 

Teils the Computer to read the STICK0 register and find the position 
of the joystick (see Figure 13-3). If the position is 15 (neutral), the Com¬ 
puter goes to line 140 and reads the joystick trigger register (&D010). 

If the joystick is moved left (11), the Computer decrements the 
horizontal position counter and pokes the spaceship's new horizontal 
Position into the HPOSPO register (&D000). 
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240/250 


260 


270 

290 - 320 


If the joystick is moved right (7), the Computer increments the 
horizontal position counter and pokes the spaceship's new horizontal 
Position into HPOSPO. 

If the joystick is moved up (14), the Computer moves the spaceship 
back one byte in player-missile RAM (line 350). Each of the 8 bytes 
that comprise the spaceship must be moved back. When the move is 
completed, the Computer decrements the vertical position counter 
(line 360). 

If the joystick is moved down (13), the Computer advances the 
spaceship one byte in player-missile RAM (line 390) and increments 
the vertical position counter (line 400). 

If the joystick is moved diagonally (10, 6, 9, or 5), the Computer ex- 
ecutes a horizontal move (after resetting the horizontal position 
register), makes a vertical move (line 350 or 390), and resets the ver¬ 
tical position counter (line 360 or 400). 

14 



Figure 13-3 Joystick Controller Positions 
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14 


SOUND 


SOUND 


Format: SOUND voice, frequency, distortion, volume, duration 
Examples: 120 SOUND 2,204,10,12,244 
100 SOUND 0,122,8,10 


Voice. There can be up to four voices specified by the numbers 0 through 3. 
Frequency. From 0-255 (see Frequency Chart, Table 14-1). 

Distortion. The default is a pure tone. Even numbers between 0 and 14 define the 
distortion. A 10 is used to create a "pure" tone. A 12 gives a buzzer sound. 


Volume. A number between 0 and 15. Use a 1 to create a sound that is barely audible. 
Use a 15 to make a loud sound. A value of 8 is considered normal. If more than one 
sound Statement is being used, the total volume should not exceed 32. This will create 
an unpleasant "clipped" tone. 


Duration. Duration is given in 1/60 of a second. The duration indicates how long a tone 
or noise will last. If you do not specify a number for the duration parameter, the tone 
will continue until the program reaches an END Statement, another RUN Statement, or 
until you type a second SOUND Statement using the same voice number followed by 
0,0,0. You can also stop the tone by pressing the key. 

Example: SOUND 2,204,10,12 
SOUND 2,0,0,0 
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TAB LE 14-1 

FREQUENCY CHART OF PITCH VALUES 



Notes 

Hex 

Decimal 

HIGH NOTES 

C 

ID 

29 


B 

1F 

31 


A# or ßt 

21 

33 


A 

23 

35 


G# or Ab 

25 

37 


G 

28 

40 


F# or Gb 

2A 

42 


F 

2D 

45 


E 

2F 

47 


D# or E 

32 

50 


D 

35 

53 


C# or Dt 

39 

57 


C 

3C 

60 


B 

40 

64 


A# or B 

44 

68 


A 

4B 

72 


G# or Ab 

4C 

76 


G 

51 

81 


F# or G b 

55 

85 


F 

5B 

91 


E 

60 

96 


D# or F b 

66 

102 


D 

6C 

108 


C# or Dt 

72 

114 

MIDDLE C 

C 

79 

121 


B 

80 

128 


A# or Bb 

88 

136 


A 

90 

144 


G# or Ab 

99 

153 


C 

A2 

162 


F# or Gb 

AD 

173 


F 

B6 

182 

LOW NOTES 

E 

CI 

193 


D# or Et 

cc 

204 


D 

D9 

217 


C# or Db 

E6 

230 


C 

F3 

243 
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Example Program: 

NIGHT LAUNCH 


10 CRAPHICS 2+16 

20 SETCOLOR 4,8,4 

30 PRINT#6, AT(3,3);"NIGHT LAUNCH" 

40 FOR DE LAY = 1 TO 1000:NEXT 

50 CRAPHICS 2 + 16 

60 PRINT#6, AT(3,3);"AT THE CAPE" 

70 FOR DELAY=1 TO 1000:NEXT 

80 GRAPHICS 0 

90 POKE 752,1 

100 SETCOLOR 6,0,0 

110 FOR T= 1 TO 24+RINT "":NEXT 

120 PRINT TAB(11 };CHR$(8);CHR$(10) 

130 PRINT TAB(11 );CHR$(22);CHR$(2) 

140 PRINT TAB(11 );CHR$(22);CHR$(2) 

150 PRINT TAB(11 );CHR$(13);CHR$(13) 

160 PRINT TAB(11 );CHR$(6);CHR$(7) 

170 FOR VOL = 15 TO 0 STEP -1 

180 SOUND 2,77,8,VOL 

190 PRINT CHR$(155)!MOVES ROCKET UP 

200 FOR R = 1 TO 200:NEXT R 

210 NEXT VOL 

220 END 

The above program is a demonstration of the SOUND Statement It decreases (by a 
loop) the volume of a distorted sound. The sound effect resembles a rocket taking off 
into outer space. 
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15 


PADDLE 

CONTROLLERS 


GAME CONTROLLERS 


ln ATARI Microsoft BASIC, the game Controllers are sensed with the PEEK instruction. 
The Controllers are attached directly to the tour Controller jacks in the front of the 
ATARI Home Computer. The PEEK locations can be given the same names listed 
below or you can give them short variable names. A complete list of PEEK locations is 
given in Appendix E. 



Figure 75-7 Game Controllers 


The following example program senses and prints the Status of paddle Controller 0 (first 
paddle in leftmost port). This PEEK can be used with other functions or commands to 
"cause" further actions like sound, graphics Controls, etc. An example is the Statement 
IF PADDLE(0)>14 THEN GOTO 440. Peeking the paddle address returns a number be- 
tween 1 and 228, with the number increasing in size as the knob on the Controller is 
rotated counterclockwise (turned to the left). 

Example of initializing and using PEEK for PADDLEfO): 

10 PADDLEfO) = 624 
20 PRINT PEEK(PADDLE(0)) 

30 GOTO 20 

PADDLE number and PEEK locations (decimal addresses): 

PADDLE(0)=624 
PADDLE(1) = 625 
PADDLE(2) = 626 
PADDLE(3)= 627 
PADDLE(4) = 628 
PADDLE(5) = 629 
PADDLE(6)=630 
PADDLE(7) = 631 
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KEYBOARD 

CONTROLLERS 


JOYSTICK 

CONTROLLERS 


Peeking the following addresses returns a Status of 0 if you press the trigger button of 
the designated Controller. Otherwise, it returns a value of 1. 


Example of using paddle trigger (0): 

10 PTRIG(0)=&27C 
20 PRINT PEEK(PTRIG(0)) 

30 GOTO 20 

PTRIG (paddle trigger) number and PEEK locations (decimal): 


PTRIG(0) = 636 
PTRIG(1)= 637 
PTRIG(2) = 638 
PTRIG(3) = 649 
PTRIG(4) = 640 
PTRIG(5) = 641 
PTRIC(6) = 642 
PTRIC(7) = 643 


Peeking the joystick locations (addresses) works in the same way as for the paddle Con¬ 
trollers, but can be used with the joystick Controller. The joystick Controllers are 
numbered 0-3 from left to right. 

Example of using joystick (0): 

10 STICK(0)= 632 
20 PRINT PEEK(STICK(0)) 

30 GOTO 20 


STICK (joystick) number and PEEK (decimal) locations: 

STICK(0)=632 
STICK(1) = 633 
STICK(2)=634 
STICK(3) = 635 


Figure 15-2 shows the PEEK number that will be returned for the various joystick posi- 
tions: 


14 



Figure 15-2 Joystick Triggers 
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Sensing the joystick triggers works the same way as for the paddle trigger buttons. It 
can be used with both the joystick and keyboard Controllers. 

Using joystick trigger (0): 

10 STR1C(0)=644 

20 PRINT PEEK(STRIG(0)) 

30 GOTO 20 


STRIG (joystick) number and PEEK (decimal) locations: 


STRIG(0) = 644 
STRIG(1) = 645 
STRIG(2)= 646 
STRIG(3) = 647 


5 REM THIS PROGRAM WILL SAY "BANG!" WHEN JOYSTICK RED BUTTON IS 

6 REM PRESSED 

10 IF PEEK(644) = 0 THEN ? "Bang!" 

20 IF PEEK(644) = 1 THEN CLS 
30 GOTO 10 


CONSOLE KEYS The following program reads the console keys on the right-hand side of the ATARI 

Computer: 

10 POKE 53279,0 
20 PRINT PEEK(53279) 

30 GOTO 20 


Peeking location 53279 (decimal) will return a number that indicates which key was 
pressed. 

7 = No key pressed 
6= ' .y.'i key pressed 
5 = *^.,4- key pressed 
3 = .. key pressed 
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APPENDIX A 

SAMPLE PROGRAMS 


DISK DIRECTORY PROGRAM 


Features used: 

• User-callable CIO routines (CIOUSR) (See Appendix N.) 

• Integers 

• VARPTR function 

• ON ERROR 

• On-Iine comments 


10 ! 

20 ! 

30 ! 

40 ON ERROR 350 
50 OPTION RESERVE(200) 

60 OPEN#1,"D:CIOUSR" INPUT 
80 ADDR = VARPTR(RESERVE) 

90 FOR 1=0 TO 159 

100 GET#1,D:POKE ADDR + l,D 

110 NEXT I 

120 CLOSE #1 

130 PUTIOCB = ADDR 

140 CALLCIO = ADDR + 61 

150 GETIOCB = ADDR+81 

160 DIM IOCB%(10) 

170 IOCB%(0) = 1 
180 IOCB%(1)=3 
190 IOCB%(2) = 6 
200 FSPEC$ = "D:*.*" 

210 ! 

220 Z = VARPTR(FSPEC$) 

230 Y = VARPTR(IOCB%(3)) 

240 POKE Y,PEEK(Z + 2) 

250 POKE Y + 1,PEEK(Z + 1) 

260 ! 

270 Z= USR(PUTIOCB,VARPTR(IOCB%(0))) 
280 ! 

290 Z= USR(CALLCIO,VARPTR(IOCB%(0))) 
300 ! 

310 ! 

320 INPUT #1,S$ 

330 PRINT S$ 

340 GOTO 320 
350 CLOSE #1 
360 END 


ROUTINE TO READ 
DISK DIRECTORY 


!GET SPACE FOR CIOUSR ROUTINES 
IOPEN FILE 

!GET STARTING ADDRESS OF RESERVED AREA 
IPOKE IN CIOUSR ROUTINES 


ITHESE ARE THE PROPER STARTING POINTS 

!FOR EACH OF THE 

IROUTINES 

'.DATA FOR ROUTINES TAKES 10 BYTES 

!USE IOCB #1 

IDO A CIO "OPEN" CALL 

IFOR DIRECTORY INPUT 

!DIR FILE SPEC 

IPUT ADDRESS OF FSPEC INTO BUFFER 
IADDRESS OF THE STRING FILESPEC 
IADDRESS OF THE PROPER ARRAY POSITION 
IHIGH ADDRESS BYTE 
ILOW ADDRESS BYTE 
PUTDATA INTO IOCB 

THEN CALL CIO 

IOCB IS SETUP AND DISK 
IS OPEN...READ DIRECTORY 
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EXPLOSION SUBROUTINE 


Feature used: Sound 

10 !TWO-LINE MAIN PROGRAM 
20 !AND SUBROUTINE TO PRODUCE 
30 !AN EXPLOSION 
40 ! 

50 GOSUB 8000 
60 STOP 
8000 ! 

8010 ! EXPLOSION SUBROUTINE 
8020 ! 

8030 SOUND 2,75,8,14 
8040 ICR = 0.79 
8050 VI =15:V2 = 15:V3 = 15 
8060 SOUND 0,NTE,8,V1 
8070 SOUND 1,NTE + 20,8,V2 
8080 SOUND 2,NTE + 50,8,V3 
8090 VI = VI * ICR 
8100 V2 = V2 * (ICR+ .05) 

8110 V3 = V3 * (ICR+ .08) 

8120 IF V3 > 1 THEN 8060 
8130 SOUND 0,0,0,0,0 
8140 SOUND 1,0,0,0,0 
8150 SOUND 2,0,0,0,0 
8160 RETURN 


FANFARE MUSIC EXAMPLE 


Feature used: Sound with duration 

10 IROUTINE TO GENERATE FANFARE MUSIC 
20 ITWO-LINE MAIN PROGRAM 
30 ! 

40 GOSUB 8000 
50 STOP 
8000 ! 

8010 1FANFARE MUSIC 
8020 ! 

8030 DUR=20:V0=181:V1=144:V2 = 121:GOSUB 8200 
8040 DUR = 7:GOSUB 8200 
8050 GOSUB 8200 

8060 DUR = 9:V0 = 162:V1 =128:V2 = 108:GOSUB 8200 

8070 DUR = 15:V0 = 181:V1 =144:V2 = 121:GOSUB 8200 

8080 V0 = 162:V1 =128:V2 = 108:GOSUB 8200 

8090 V0 = 153:V1 =128:V2 = 96:V3 = 193 

8100 For 1=2 TO 14 

8110 SOUND 3,V0,10,I 
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8120 SOUND 1/VI ,10,1 
8130 SOUND 2,V2,10,I 
8140 SOUND 0,V3,10,1 
8150 FOR J =1 TO 100;NEXT J 

8160 NEXT I 

8170 FOR J = 1 TO 200:NEXT J 
8180 SOUND 0,0,0,0,0 
8185 SOUND 1,0,0,0,0 
8190 SOUND 2,0,0,0,0 
8195 SOUND 3,0,0,0,0 
8197 RETURN 

8200 ISOUND GENERATOR 
8210 SOUND 0,V0,10,8,DUR 
8220 SOUND 1,VI,10,8,DUR 
8230 SOUND 2,V2,10,8,DUR 
8240 ! 

8250 !NOW STOP THE SOUND 
8260 ! 

8270 SOUND 0,0,0,0,0 
8280 SOUND 1,0,0,0,0 
8290 SOUND 2,0,0,0,0 
8295 FOR J =1 TO 250:NEXT J 
8300 RETURN 


EXAMPLE OF ATARI PIANO 

Features used: 

• OPEN Statement 

• String array 

• INKEYS 

• SOUND 

• On-Iine comments 


10 ! EXAMPLE PROCRAM TO 
20 ! CONVERT YOUR ATARI 
30 ! COMPUTER INTO A PIANO! 

40 ! 

50 I 

60 ! FIRST, SET UP A 2-OCTAVE 
70 ! SCALE OF KEYS TO PRESS 
80 ! AND NOTES TO PLAY 
90 DIM SCALE$(15) 

100 DIM PITCH(15) 

110 I NOW READ THESE INTO 
120 ! THEIR RESPECTIVE TABLES 
130 OPEN #1, "D.-NOTES.DAT" INPUT 
140 FOR 1 = 1 TO 15 
150 INPUT #1,S$,P 
160 SCALE$(I)=S$:PITCH(I)=P 



170 NEXT I 

180 CLOSE #1 

190 PRINT "PLAY, BURT, PLAY!" 

200 ! 

210 ! BEGIN TESTING FOR KEYS 
220 ! BEINC PRESSED 
230 ! 

240 N$ = INKEY$ 

250 IF N$ ="" THEN GOTO 240 ELSE GOTO 320 
260 ! 

270 ! WH EN A KEY IS PRESSED, 

280 ! SEE IF ITS ONE ON OUR 
290 ! PIANO KEYBOARD! 

300 ! 

310 ! 

320 FOR I = 1 TO 15 

330 IF N$ = SCALE$(I) GOTO 380 

340 NEXT I 

350 GOTO 240 !NOT A GOOD KEY, TRY AGAIN 
360 ! FOUND A GOOD KEY, PROCESS IT 
370 ! 

380 VOLUME = 8 

390 SOUND 1,PITCH(I),10,VOLUME,15 
400 GOTO 240 
410 END 


Sample NOTES.DAT FILE 

First item is the key to be pressed. 

Second item is the frequency to play. 


NOTE.DAT CREATION PROGRAM 

10 IPROGRAM TO CREATE NOTES.DAT FILE 
20 ! 

30 DIM NOTES$(15),PITCH(15) 

40 FOR 1 = 1 TO 15 

50 INPUT "ENTER KEY, FREQ. FOR KEY :";NOTES$(l),PITCH(l) 
60 NEXT I 

70 OPEN $1,"D:T" OUTPUT 

80 FOR 1=1, TO 15 

90 PRINT $1,NOTES$(l);",";PITCH(l) 

100 NEXT I 
110 CLOSE $1 
120 END 


Enter the following values to get a 2-octave scale. 

Z, 243 
X, 217 
C, 193 
V, 182 
B, 162 
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N, 144 
M, 128 
A, 121 
S, 108 
D, 96 

F, 91 

G, 81 

H, 72 

J, 64 

K, 60 


DECIMAL-TO-HEX CONVERSION ROUTINE 

Features used: 

• String array 

• Integers 

• On-Iine comments 


20 ! 

30 ! D E C H E X 
40 ! 

50 ! 

60 ! 

70 !PROGRAM TO CONVERT AN INPUT 
80 IDECIMAL NUMBER TO ITS 
90 IHEXADECIMAL EQUIVALENT 
100 ! 

110 ! 

130 DIM HEX$(15):DIM HEXBASE(4) 

140 FOR 1=0 TO 15 
150 READ HEX$(I) 

160 NEXT I 

170 FOR 1=0 TO 4 

180 READ HEXBASE(I) 

190 NEXT I 

200 DATA 0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F 
210 DATA 0,4096,256,16,1 
220 ! 

230 !GET THE DECIMAL NO. 

240 ! 

250 INPUT "ENTER THE DECIMAL NO. :";DEC 
260 IF DEC = 0 THEN 500 ISTOP 
270 ! 

280 IPROCESS EACH HEX DIGIT 
290 ! 

300 FOR J = 1 TO 4 

305 IF J =4 THEN ANS% = DEOGOTO 350 
310 ANS% = (DEC/HEXBASEU)) - .5 
320 IF ANS% < 1 THEN ANS% = 0 
330 DEC = DEC - (ANS% * HEXBASE(J)) 

340 I 

350 ! FIND THE HEX DIGIT FOR FIRST POSITION 
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360 FOR 1% = 0 TO 15 

370 IF ANS% = 1% THEN GOTO 420 

380 NEXT 1% 

390 !IF WE COT HERE ITS AN ERROR! 

400 PRINT " DECIMAL INPUT CAN'T BE COMPUTED" 
410 PRINT "PLEASE TRY AGA IN": GOTO 250 
420 HEXNO$ = HEXNOS + HEX$(I%) 

430 NEXT J 
440 ! 

450 !PRINT THE HEX NO. AND GO FOR ANOTHER 
460 ! 

470 PRINT "HEX NO. = ";HEXNO$ 

480 HEXNOS = "" 

490 GOTO 250 
500 END 


VERTICAL FINE SCROLLING 


Features used: 

• Fine scrolling 

• VARPTR 

• OPTION RESERVE and CHR 

• User-defined display list 


10 DEFINT A-Z 

20 OPTION RESERVE(3000) IAREA FOR SCREEN RAM 
30 OPTION CHR1 IAREA FOR DISPLAY LIST 
40 ADDR = VARPTR(CHRI) 

50 CADDR = VARPTR(RESERVE) 

60 VSCROL = &D405 IVERTICAL SCROLL REGISTER 
70 LCADDR = 0 

80 HCADDR = ((CADDR AND &FF00)/256) AND &FF 

90 FOR 1=0 TO 99 IZERO THE DISPLAY LIST AREA (IST 100 BYTES) 

100 POKE ADDR+ l,0:NEXT I 

110 LADDR = ADDR AND &FF 

120 HADDR = ((ADDR AND &FF00)/256) AND &FF 

130 LMSLO = ADDR + 4 IADDRESS OF LOAD 

140 LMSHI = ADDR + 5 IMEMORY SCAN BYTES (LMS) 

150 FOR 1 = 0 TO 18 IPOKE IN NEW DISPLAY LIST 
160 READ D IFROM DATA STMTS. 190-210 
170 POKE ADDR+ l,D 
180 NEXT I 

190 DATA &70,&70,&70,&67,&00,&00,&27,&27 
200 DATA &27,&27,&27,&27,&27,&27,&27,&27 
210 DATA &27,&07,&41 

220 POKE ADDR + 19,LADDR (LAST 2 BYTES POINT BACK 

230 POKE ADDR + 20,HADDR ITO TOP OF DISPLAY LIST 

240 POKE LMSLO,LCADDR:POKE LMSHI,HCADDR ITELLS SCREEN RAM START 

250 K = -1 1250 - 320 LOAD DATA INTO 

260 FOR 1=1 TO 300 ISCREEN RAM AREA, A PAGE FULL 

270 K = K + 1:POKE CADDR + K,33 !OF A's AND THEN THE ALPHABET 
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280 NEXT I 

290 FOR 1 = 34 TO 58 

300 FOR J =1 TO 20 

310 K = K + 1:POKE CADDR+K,I 

320 NEXT J,l 

330 POKE &22F,0 !TURN OFF ANTIC 

340 POKE &230,LADDR STELL IT WHERE MY DISPLAY 

350 POKE &231,HADDR ILIST IS, AND ... 

360 POKE &22F,&22 1TURN ANTIC BACK ON 

370 REM HERE IS THE REAL PROGRAM 

380 FOR 1=1 TO 15 1380 - 410 DO THE VERTICAL 

390 POKE VSCROLJ ! FlNE SCROLL 

400 FOR W = 1 TO 30:NEXT W 

410 NEXT I 

420 CADDR = CADDR+20 !CALCULATE WHERE NEXT LINE OF 
430 LCADDR = CADDR AND &FF ISCREEN RAM STARTS 

440 HCADDR = ((CADDR AND &FF00)/256) AND &FF !FOR THE COARSE SCROLL 
450 WAIT &D40B,&FF,96 !WAIT UNTIL TV VERTICAL LINE COUNTER HITS 96 
460 POKE VSCROL,0 ITHEN SET CHARACTERS BACK TO ORIGINAL POSITION 
470 POKE LMSLO,LCADDR !AND COARSE 

480 POKE LMSHI,HCADDR ISCROLL BY CHANGING LMS BYTE IN DISPLAY LIST 
490 GOTO 380 
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APPENDIX B 


GRAPHICS MODES PROGRAMS 


MICROBE INVASION EXAMPLE 

10 REM MICROBE INVASION 

15 REM SPIRAL CREATURES TAKE OVER SCREEN 

16 REM 10 PERCENT CHANCE SCREEN CHANGES MODE 

17 REM WHEN CREATURE GOES OUT OF BOUNDS 
30 RANDOMIZE 

40 MODE = RND(8) 

50 GRAPHICS MODE+16 
60 PIX= RND(15) 

70 SETCOLOR 0,PIX,6 
80 COLOR 1 
90 BAK= RND(255) 

100 POKE 712,BAK 
110 X = RN D(150):Y = RN D(100) 

120 IF X>140 THEN 40 
130 Z = 2 

140 NUM = NUM + 1 
150 FOR DOTS = 1 TO Z 
160 IF NUM = 5 THEN NUM = 1 
170 ON ERROR GOTO 230 
180 PLOT X,Y 

190 ON NUM GOSUB 250,270,290,310 
200 NEXT 
210 Z = Z + 1 
220 GOTO 140 

230 GRAPHICS MODE + 32+16INO TEXT WINDOW, NO SCREEN CLEAR 

240 RESUME 60 

250 X= X + 1 :Y = Y +1 

260 RETURN 

270 X=X + 1:Y = Y-1 

280 RETURN 

290 X = X-1 :Y = Y-1 

300 RETURN 

310 X=X-1:Y = Y + 1 

320 RETURN 
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The following short program makes use of RANDOMIZE and RND to print three-letter 
words and three-letter abbreviations of government agencies. 

10 RANDOMIZE ISeeds the RND function 

20 GRAPHICS 2 + 16 

30 X=RND(26) + 96 IMake first letter 

40 Y=RND(5) IMake a vowel for middle letter 

50 IF Y = 1 THEN Y = 97 IMake an A 

60 IF Y = 2 THEN Y = 101 IMake an E 

70 IF Y = 3 THEN Y = 105 IMake an I 

80 IF Y = 4 THEN Y = 111 IMake an O 

90 IF Y = 5 THEN Y = 117 IMake a U 

100 Z = RND(26)+96 IMake last letter 

110 PRINT#6, AT(9,3);CHR$(X);CHR$(Y);CHR$(Z) 

120 FOR DELAY = 1 TO 2000:NEXT 
180 GOTO 30 
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APPENDIX C 


ALTERNATE CHARACTER SETS 


ATARI Home Computers Support several Standard character sets that are stored as 
part of the Operating System (OS) ROM. These include all the upper- and lowercase 
alphabet, numbers, special characters, and a special graphics character set. At times, 
however, it is very useful to be able to define your own character set. Applications for 
this capability that immediately come to mind include character-driven animation, 
foreign language word Processing, and background graphics for games (for instance, a 
map or special playfield). 

ATARI Computers and ATARI Microsoft BASIC readily support this ability. This is easy 
for the ATARI Home Computer because the OS data base contains a pointer (CHBAS) 
at hex location 2F4 (decimal location 756) which points to the character set to be used. 
Normally this points at the Standard character set in the OS ROM. But in BASIC, you 
can POKE your own character set into a free area of RAM (set aside with the OPTION 
CHR1 or OPTION CHR2 Statement) and then reset the OS pointer, CHBAS, to point to 
your new character set. The Computer will instantly begin using the new characters. 

There are several important things to keep in mind when redefining the character set: 


• Graphics mode 0 needs 128 characters defined (OPTION CHR1). Graphics 
modes 1 and 2 allow only 64 characters (OPTION CHR2). 

• All 64 or 128 characters need to be defined even though you may only wish to 
change and use one character; this is easily accomplished by transferring the 
ROM characters into your RAM area and then changing the desired character to 
its new configuration. 

• The 64-character set requires 512 bytes of memory (8 bytes per character) and 
must Start on a 'A K boundary. The 128-character set requires 1024 bytes of 
memory and must start on a 1K boundary. The programmer need not worry 
about these restrictions when using the CHR1 and CHR2 options; the area is 
allocated to begin on the proper boundary. 

• The value that is poked into CHBAS after the character set is defined is the page 
number in memory where the character set begins. This value can be computed 
with the following Statement: 

CHBAS% = (VARPTR(CHRn)/256) AND &FF 

Where "n" is either 1 or 2. This value is then poked into location &2F4 
(decimal 756). 
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The most time-consuming process in using an alternate character set is creating the 
characters. Each character consists of 8 bytes of memory, stacked one on top of the 
other (see Figure C-1). Visualize each character as an 8x8 square of graph paper. 
Darken the necessary square on the graph paper to create a character (see Figure C-2). 
Then, each row of the 8x8 square is converted from this binary representation (where 
each darkened square is a 1 and each blank square is a zero) to a hex or decimal 
number (see Figure C-2). These numbers are then poked into the appropriate bytes of 
the RAM area, from top to bottom in these figures, to define the character in RAM. The 
first 8 bytes of the reserved (OPTION CFIR1 or CFIR2) area define the zeroth character; 
the next 8 bytes define the first character, and so on. After transferring the Standard 
character set from its ROM location to the reserved CFIR1 or CF)R2 area, any character 
can be redefined by finding its starting position in the area, then poking the new bytes 
into the starting byte and the next 7 bytes. After all necessary characters are redefined, 
poke the new page number intoCHBAS and the new character will immediately be ac- 
tive. Use BASIC PRINT Statements to display the new characters; for instance, if you 
have redefined the "A" to be a solid block and use the Statement, 


PRINT "A", 


the new character will be printed. 


A little experimentation with this process will quickly show you how powerful this 
capability can be. The program on the following page is an example of character set 
redefinition. 



Figure C-1 Amount of Memory per Character 


Byte 

No. Binary Hex Decimal 



00110000 = 

30 - 

48 

00110000 = 

30 = 

48 

11111000 = 

F8 = 

248 

00011100 = 

IC = 

28 

00001110 = 

OE = 

14 

00000111 = 

07 = 

07 

00000011 = 

03 - 

03 

00000011 = 

03 = 

03 


Figure C-2 Redefining a Character 





SAMPLE PROGRAM 


10 ! 

20 IPROCRAM TO DEMONSTRATE 

30 1ALTERNATE CHARACTER SET 
40 ! DE Fl NITION 
50 ! 

60 !THE PROGRAM REDEFINES THE 
70 ICHARACTERS A,B,C,D,E,F,C,H 
80 ! 

90 CHBAS = &2F4 !CHR. SET POINTER 
100 OPTION CHR1 IALLOCATE CHARACTER SET AREA 
110 ADDR% = VARPTR(CHR1) !FIND STARTINC ADDRESS 
120 PAGENO% = (ADDR%/256) AND &FF ICALCULATE PAGE 
130 ! 

140 MOVE 57344,ADDR%,1024 IMOVE CHR. SET DOWN INTO RAM 
150 ! 

160 OFFSET = 33*8 IOFFSET TO "A" 

170 FOR 1=0 TO 63 !CET NEW CHARACTERS 
180 READ C 

190 POKE ADDR% + OFFSET + l,C !AND INSERT 
200 NEXT I 
210 ! 

220 IDATA STATEMENTS ARE BY CHARACTER 
230 ! 

240 DATA &07,&0F,&1F,&3F,&7F,&FF,&FF,&FF 
250 DATA &E0,&F0,&F8,&FC,&FE,&FF,&FF,&FF 
260 DATA &FF,&FF,&FF,&7F,&3F,&1F,&0F,&07 
270 DATA &FF,&FF,&FF,&FE,&FC,&F8,&F0,&E0 
280 DATA &00,&00,&00,&3F,&7F,&FF,&FF,&FF 
290 DATA &00,&00,&00,&FC,&FE,&FF,&FF,&FF 
300 DATA &FF,&FF,&FF,&7F,&3F,&00,&00,&00 
310 DATA &FF,&FF,&FF,&FE,&FC,&00,&00,&00 
320 ! 

330 POKE CHBAS.PAGENO% 1SWITCH TO NEW CHARACTER SET! 
340 ! 

350 POKE &2F0,1 !TURN OFF CURSOR 
360 SETCOLOR 6,2,6 370 X = 20 
380 FOR Y = 10 TO 20 
390 WAIT &D40B,&FF,110 
400 CLS: PRINT AT... 

410 PRINT AT(X,Y + 1):"CD" 

420 FOR W = 1 TO 30:NEXT W 

430 NEXT Y 

440 CLS: PRINT AT... 

450 PRINT AT(X,22);"GH" 

460 SOUND 0,79,10,8,4 
470 FOR W = 1 TO 80:NEXT W 
480 FOR Y = 20 TO 10 STEP -1 
490 WAIT &D40B,&FF,110 
500 CLS: PRINT AT... 

510 PRINT AT(X,Y + 1);"CD" 

520 FOR W = 1 TO 30:NEXT W 
530 NEXT Y 
540 GOTO 380 
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APPENDIX D 


DERIVED FUNCTIONS 


The following trigonometric functions can be derived by the calcuJations shown. 


Derived Functions 


Derived Functions in Terms of Microsoft 


Secant 

SEC(X) = 1/COS(X) 

Cosecant 

CSC(X) = 1/SIN(X) 

Inverse sine 

ARCS1 N(X) = ATN(X/SQR(-X*X +1)) 

Inverse cosine 

ARCCOS(X) --ATN(X/SQR(-X*X +1) + CONSTANT)) 

Inverse secant 

ARSEC(X)=ATN(SQR(X*X-1)) + (SC N(X-1)* CON¬ 
STANT) 

Inverse cosecant 

ARCCSC(X)= ATN(1/SQR(X*X-1)) 

+ (SGN(X-1)*CONSTANT) 

Inverse contangent 

ARCCOT(X) = ATN(X)+CONSTANT 

Hyperbolic sine 

SINH(X) = (EXP(X>EXP(-X))/2 

Hyperbolic cosine 

COSH(X) = (EXP(X)+ EXP(-X))/2 

Hyperbolic tangent 

TAN H(X) =-EXP(-X)/(EXP(X) + EXP(-X))* 2 +1 

Hyperbolic secant 

SECH(X) = 2/(EXP(X)+ EXP(-X)) 

Hyperbolic cosecant 

CSCH(X)= 2/(EXP(X>EXP(-X)) 

Hyperbolic cotangent 

COTH(X)= EXP(-X)/(EXP(X>EXP(-X))*2 +1 

Inverse hyperbolic sine 

A RCS1N H(X) = LOG(X + SQR(X*X +1)) 

Inverse hyperbolic cosine 

ARCCOS H(X)+ LOG(X+ SQR(X*X-1)) 

Inverse hyperbolic tangent 

ARCTAN H(X) = LOG((1 + X)/(1-X))/2 

Inverse hyperbolic secant 

ARCSECH(X)=LOG((SQR(-X*X + 1) + 1)/X) 

Inverse hyperbolic cosecant 

ARCCSCH(X) = LOG((SG N(X)* SQR(X*X +1) +1 )/X) 

Inverse hyperbolic cotangent 

ARCCOTH(X) = LOG((X +1 )/(X-1 ))/2 
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APPENDIX E 


MEMORY LOCATIONS 


Memory locations are expressed in hexadecimal, with decimal equivalents in paren- 
theses. For additional information, see the ATARI Personal Computer System Technical 
Users Notes (part number C016555). 


MEMORY MAP 


The 6502 Microprocessor is divided into four basic memory regions: RAM, cartridge 
area, I/O chip region, and resident OS ROM. Memory regions and their address boun- 
daries are listed below: 


RAM (minimum required for Operation): 
RAM expansion area: 

Cartridge B (left cartridge) or 8K RAM: 
Cartridge A (right cartridge) or 8K RAM: 
Unused: 

I/O chips: 

OS floating point package: 

Resident Operating System ROM: 


0000-1 FFF (0-8191) 
2000-7FFF (8192-32767) 
8000-9FFF (32768-40959) 
A000-BFFF (40960-49151) 
C000-CFFF (49152-53247) 
D000-D7FF (53248-55295) 
D800-DFFF (55296-57343) 
E000-FFFF (57344-65535) 


RAM REGION 


The RAM region, shared by the OS and the program in control, is divided into the 
following subregions: 

• 6502 Microprocessor Page 0 Address Mode Region: 0000 through 00FF (0-255) 
allocated as follows: 

0000 through 007F (0-127): OS 

0080 through 00FF (128-255): User applications 

00D4 through 00FF (212-255): Floating point package, if used. 

• Page 1, 6502 Flardware Stack Region: 0100 through 01 FF (256-511). 

Note: At power up or jSgSffigülffa. the stack location points to address 01 FF (511) and 
the stack then pushes downward toward 0100 (256). The stack wraps around from 0100 
to 01 FF if a stack overflow occurs. 


• Pages 2-4, OS Data Base (working variables, tables, data buffers): 0200 through 
047 F (512-1151). 

• Pages 7-XX, User Boot Area: 0700 (1792) to Start of free RAM area, where XX is a 
function of the screen graphics mode and the amount of RAM installed. 


Note: When initial diskette startup is completed, the data base variable points to the 
next available location above Software loaded. When no Software is entered by the the 
initial diskette startup, the data base variable points to location 0700. 


• Screen Display List and Data: Page XX to top of RAM. Data base pointer con- 
tains address of last available location below the screen area. 
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CARTRIDGE Cartridge B is the RICHT CARTRIDGE on the ATARI 800 Home Computer. Cartridge A 

AREA is the LEFT CARTRIDGE on the ATARI 800 Home Computer and the only cartridge on 

the ATARI 400 Home Computer. 

• Cartridge B: 8000 through 9FFF (32768-40959) 

• Cartridge A: A000 through BFFF (40960-49151) for 8K cartridges; 8000 through 

BFFF (32768-49151) for 16K cartridges (optional) 

Note: On the ATARI 800 Home Computer, if a RAM module plugged into the last slot 
overlaps any of these cartridge addresses, the installed cartridge will disable the con- 
flicting RAM module in 8K increments. 

I/O CHIPS The 6502 Microprocessor performs input/output operations by addressing the follow- 

ing external support chips as memory: 

• CTIA D000 through D01F (53248-53279) 

• POKEY D200 through D21F (53760-53791) 

• PIA D300 through D31F (54016-54047) 

• ANTIC D400 through D41F (54272-543030) 

Some of the chip registers are read/write; others are read only or write only. Table E-2 
lists the registers and their addresses by chip. For additional information, see the 
ATARI Personal Computer System Technical Users Notes. 

RESIDENT The region from D800 through FFFF (55296-65535) permanently contains the OS and 

OS ROM the floating point package: 

• Floating point package: D800 through DFFF (55296-57343) 

• Operating System ROM: E000 through FFFF (57344-65535) 

The OS contains many vectored entry points, all fixed, at the end of the ROM and in 
RAM. The floating point package is not vectored, but all documented entry points will 
be fixed. See the Appendix of the ATARI Personal Computer System OS Users Manual 
(part of the ATARI Personal Computer System Technical Users Notes ) for listings of the 
fixed ROM vectors and entry points. 


TABLE E-1 

USEFUL OS DATA BASE ADDRESSES 


Address 

Hex 

Dec 

Name 

Byte 

Size 

Function 

MEMORY CONFIGURATION (See Sections 4 and 7, ATARI Personal Computer System OS Users Manual, part of 

ATARI Personal Computer System Technical Users Notes.) 

000 E 

14 

APPMHI 

2 

User-free memory screen lower limit 

006A 

106 

RAMTOP 

1 

Display handler top of RAM address (MSB) 

02 E4 

740 

RAMSIZ 

1 

Top of RAM address (MSB) 

02E5 

741 

MEMTOP 

2 

User-free memory high address 

02 E7 

743 

MEMLO 

2 

User-free memory low address 
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TEXT/GRAPHICS SCREEN (See Section 5, OS Users Manual.) 


Screen Margins (text modes; text window) 


0052 

82 

LMARGN 

1 

0053 

83 

RMARGN 

1 

Cursor Control 



0054 

84 

ROWSCRS 

1 

0055 

85 

COLCRS 

2 

005A 

90 

OLD ROW 

1 

005 B 

91 

OLDCOL 

2 

0290 

656 

TXT ROW 

1 

0291 

657 

TXTCOL 

2 

02 F0 

752 

CRSINH 

1 


Color Control 




02 C0 

704 

PCOLRO 

4 

02 CI 

705 

PCO L RI 

4 

02C2 

706 

PCOLR2 

4 

02C3 

707 

PCOLR3 

4 

02C4 

708 

COLORO 

5 

02C5 

709 

COLOR1 

5 

02C6 

710 

COLOR2 

5 

02C7 

711 

COLOR3 

5 

02C8 

712 

COLOR4 

5 


Attract Mode 



004D 77 

ATRACT 

1 

Tabbing 



02A3 675 

TABMAP 

15 

Screen Memory 



0058 88 

SAVMSC 

2 

Split-Screen Memory 



0294 660 

TXTMSC 

2 


Left screen margin (0-39; default 2) 
Right screen margin (0-39; default 39) 


Current Cursor row 

Current Cursor column 

Prior Cursor row 

Prior Cursor column 

Current Cursor row in text window 

Current Cursor column in text window 

Cursor display inhibit flag 

(0 = Cursor on, 1 = Cursor off) 


Color-Iuminance Player-Missile 0 
Color-Iuminance of Player-Missile 1 
Color-Iuminance of Player-Missile 2 
Color-Iuminance of Player-Missile 3 
Color-Iuminance of Playfield 0 
Color-Iuminance of Playfield 1 
Color-Iuminance of Playfield 2 
Color-Iuminance of Playfield 3 
Color-Iuminance of background 


Attract mode timer and flag 

(Value 128 = on; turns on every 9 minutes) 


Tab stop bit map (default: 7, 15, 23, 
etc. to 119) 


Upper left corner of screen 


Upper left corner of text window 
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DRAW/FILL Function 


0060 

96 

NEWROW 

1 

Destination point; initialized to value in ROWCRS. 

0061 

97 

NEWCOL 

2 

Destination point; initialized to value in COLCRS. 

02 FD 

765 

FILDAT 

1 

Fill data for graphics FILL command. 


Internal Character Code Conversion 

02FA 762 ATACHR 1 Contains last ATASCII character or plot point. 


Display Control Characters 

02FE 766 DSPFLG 1 Display control character flag. 

(1 = display control characters) 


KEYBOARD (See Section 5, OS Users Manual.) 


Key Reading 


02FC 764 

CH 

1 

Contains value of last keyboard character in FIFO or 
$FF if FIFO is empty. 

Special Functions 

0011 17 

BRKKEY 

1 

aSSÜS» key flag (normally nonzero; set to 0 by MB») 

02B6 694 

INVFLG 

1 

Inverse video flag (norm = 0; set by §j key) 

02 BE 702 

SHFLOK 

1 

Shift/control lock control flag ($00 = no lock (norm); 
$40 = caps lock; $80 — control lock) 

02FF 767 

SSFLAG 

1 

Start/stop flag (norm - 0; set by §§gg§ 1). Set to $40 on 
power up and ilgttiäMEtHBfc reset by jg^flB^I. 

QBÜorBSS 

CENTRAL I/O (CIO) ROUTINE (See Section 5, 

OS Users Manual.) 

I/O Control Block 

0340-034F (832-847) IOCB 


16 

I/O Control Block 0 

0350-035F (848-863) IOCB 


16 

I/O Control Block 1 

0360-036F (864-879) IOCB 


16 

I/O Control Block 2 

0370-037F (880-895) IOCB 


16 

I/O Control Block 3 

0380-038F (896-911) IOCB 


16 

I/O Control Block 4 

0390-039F (912-927) IOCB 


16 

I/O Control Block 5 

03A0-03AF (928-943) IOCB 


16 

I/O Control Block 6 

03B0-03BF (944-959) IOCB 


16 

I/O Control Block 7 
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0340 

832 

ICHID 

1 

Händler I.D. (See Section 5; Initialized to $FF at power 
up and 

0341 

833 

ICDNO 

1 

Device number 

0342 

834 

ICCMD 

1 

Command byte 

0343 

835 

ICSTA 

1 

Status 

0344 

836 

ICBAL/ICBAH 

2 

Buffer address 

0346 

838 

ICPTL/ICPTH 

2 

PUT BYTE vector (Points to ClO's "IOCB not OPEN" at 
power up and 

0348 

840 

ICBLL/ICBLH 

2 

Buffer length/byte count 

034A 

842 

ICAX1/ICAX2 

2 

Auxiliary information 

034C 844 

Zero Page IOCB 

ICAX3/ICAX6 

4 

Spare bytes for handler use 

0020 

32 

ZIOCB 

16 

Zero page IOCB (Only the first 12 bytes (lOCBs) are 
moved by the CIO utility.) 

0020 

32 

ICHIDZ 

1 

Handler index number (set to $FF on CLOSE) 

0021 

33 

ICDNOZ 

1 

Device drive number 

0022 

34 

ICCOMZ 

1 

Command byte 

0023 

35 

ICSTAZ 

1 

Status byte 

0024 

36 

ICBALZ,ICBALH 

2 

Buffer address 

0026 

38 

ICPTLZ,ICPTHZ 

2 

PUT BYTE vector (Points to ClO's "IOCB not OPEN" 
on CLOSE.) 

0028 

40 

ICBLLZJCBLHZ 

2 

Buffer length/byte count 

002A 

42 

ICAX1ZJCAX2Z 

2 

Auxiliary information 

0002C 44 

DEVICE STATUS 

ICSPRZ 

(ICIDNOJCOCHR) 

4 

CIO working variables 

CIDNO = ICSPRZ + 2; ICOCHR = ICSPRZ+3(See 
Sections 5 and 9 of the OS Users Manual.) 

02EA 746 DVSTAT 4 

DEVICE TABLE (See Section 9, OS Users Manual.) 

Device Status 

031A 749 HATABS 38 

SERIAL I/O (SIO) ROUTINE (See Section 9, OS Manual.) 

Device Control Block 

Device handler table 

0300030 B (768-779) 

D C B 

12 

Device control block 

0300 

768 

DDEVIC 

1 

Device bus I.D. 

0301 

769 

DUNIT 

1 

Device unit number 
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0302 

770 

DCOMND 

1 

Device command 

0303 

771 

DSTATS 

1 

Device Status 

0304 

772 

DBUFLO.DBUFHI 

2 

Händler buffer address 

0306 

774 

DTIMLO 

1 

Device timeout (See Section 9, OS Users Manual.) 

0308 

776 

DBYTLO,DBYTHI 

2 

Buffer length/byte count (See Section 9, OS Users 
Manual .) 

030A 778 

BUS SOUND CONTROL 

DAUX1,DAUX2 

2 

Auxiliary information 

0041 

65 

SOUNDR 

1 

Quiet/noisy I/O flag (0 = quiet) 

ATARI CONTROLLERS (See Appendix L, OS Users Manual. 

) 

Joysticks 

0278 

632 

STICK0-STICK3 

4 

Joystick position port 

0284 

644 

STRIC0-STRIG3 

4 

Joystick trigger port 

Paddies 

0270 

624 

PADDL0-PADDL7 

8 

Paddle position port 

027C 

636 

PTRIG0-PTRIG7 

8 

Paddle trigger port 

Light Pen 

0234 

564 

LPENH 

1 

Light pen horizontal position code 

0235 

565 

LPENV 

1 

Light pen vertical position code 

0278 

632 

STICK0-STICK3 

4 

Light pen button port 

FLOATING POINT PACKAGE (See Section 8, OS Users Manual.) 

00D4 

212 

FR0 

6 

Floating point register 0 

00E0 

224 

FR1 

6 

Floating point register 1 

00F2 

242 

CIX 

1 

Character index 

00 F3 

243 

INBUFF 

1 

Input text buffer pointer 

00FB 

251 

DECFLG/RADFLC 

1 

Degrees/radians flag (0 — DEGFLG; 6 = degrees; 
DEGFLC = 0) 

00 FC 

252 

FLPTR 

2 

Pointer to floating point number 

0580 

1408 

LBUFF 

96 

Text buffer 
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POWER UP AND B ffECTBf&Si (See Section 7, OS Users Manual.) 

Diskette/Cassette Boot 

0002 2 CASINI 2 Cassette boot initialization vector 

000C 12 DOSINI 2 Diskette boot initialization vector 


Environment Control 


0008 

8 

WÄRMST 

1 

Warmstart flag (= 0 on power up; $FF on 

000A 

10 

DOSVEC 

2 

Noncartridge control vector 
(See Section 10, OS Users Manual.) 

INTERRUPTS (See Secton 6, OS Users Manual. 

) 


0010 

16 

POKMSK 

1 

POKEY interrupt mask 

0042 

66 

CRITIC 

1 

Critical code section flag 
(nonzero = executing code is critical) 

Real Time Clock 




0012 

18 

RTCLOK 

3 

Real time frame counter (1/60 sec) 

( + 0 = MSB; +1 = NSB; +2 = LSB) 

System VBLANK Timers 




0218 

536 

CDTMV1 

2 

System timer 1 value 

021A 

538 

CDTMV2 

2 

System timer 2 value 

021C 

540 

CDTMV3 

2 

System timer 3 value 

021 E 

542 

CDTMV4 

2 

System timer 4 value 

0020 

544 

CDTMV5 

2 

System timer 5 value 

0226 

550 

CDTMA1 

2 

System timer 1 jump address 

0228 

552 

CDTMA2 

2 

System timer 2 jump address 

022A 

554 

CDTMF3 

2 

System timer 3 flag 

022C 

556 

CDTMF4 

1 

System timer 4 flag 

022 E 

558 

CDTMF5 

2 

System timer 5 flag 

NMI Interrupt Vectors 




0200 

512 

VDSLST 

2 

Display list interrupt vector 
(not used by the OS) 

0222 

546 

VVBLKI 

2 

Immediate VBLANK vector 

0224 

548 

VVBLKD 

2 

Deferred VBLANK vector 
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IRQ Interrupt Vectors 


0202 

514 

VPRCED 

2 

0204 

516 

VINTER 

2 

0206 

518 

VBREAK 

2 

0208 

520 

VKEYBD 

2 

020A 

522 

VUSERIN 

2 

020C 

524 

VSEROR 

2 

020E 

526 

VSEROC 

2 

0210 

528 

VTIMR1 

2 

0212 

530 

VTIMR2 

2 

0214 

532 

VTIMR4 

2 

0216 

534 

VIMIRQ 

2 


Hardware Register Updates 


0230 

560 

SDLSTL 

1 

0231 

561 

SDLSTH 

1 

02C0 

704 

PCOLRx 

4 

02C4 

708 

PCOLORx 

5 

02 F3 

755 

CHACT 

1 

02 F4 

756 

CHBAS 

1 


Serial I/O bus proceed signal 
Serial I/O bus interrupt signal 
BREAK instruction vector 

Keyboard interrupt vector 
Serial I/O bus receive data ready 
Serial I/O bus transmit ready 
Serial I/O bus transmit complete 
POKEY timer vector (not used by OS) 
POKEY timer vector (not used by OS) 
POKEY timer vector (not used by OS) 
General IRQ vector 


Screen display list address 

Screen display list address 

Color register 

Color register 

Character control 

Character address base register 

($E0= uppercase, number set; $E2= lowercase, special 

graphics set; default = $EO) 


USER AREAS (See Section 4, OS Users Manual .) 

Note: The following areas are available to the user in a nonnested environment. 


0080 128 128 

0480 1152 640 
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Note: For additional information refer to the A TARI Personal Computer System Hardware Manual (part of the ATARI 
Personal Computer System Technical Notes). 


TABLE E-2 

HARDWARE ADDRESSES 


Address 


Register 


OS 

Shadow 


Hex 

Dec 

Name 

Function 

Hex 

Dec 

Name 

ANTIC CHIP 






D400 

54272 

DMACTL 

Direct memory access (DMA) 
control (WRITE) 

22F 

559 

SDMCTL 

D401 

54273 

CHACTL 

Character control (WRITE) 

2F3 

755 

CHART 

D402 

54274 

DLISTL 

Display list pointer 
low byte (WRITE) 

230 

560 

SDLSTL 

D403 

54275 

DLISTH 

Display list pointer 
high byte (WRITE) 

231 

561 

SDLSTH 

D404 

54276 

HSCROL 

Horizontal scroll (WRITE) 




D405 

54277 

VSCROL 

Vertical scroll (WRITE) 




D407 

54279 

PMBASE 

Player-missile base address 
(WRITE) 




D409 

54281 

CHBASE 

Character base address 
(WRITE) 

2F4 

756 

CH BAS 

D40A 

54282 

WSYNC 

Wait for horizontal sync 
(WRITE) 




D40B 

54283 

VCOUNT 

Vertical line counter (READ) 




D40E 

54286 

NMIEN 

Nonmaskable interrupt (NMI) 
enable (WRITE) 




D40F 

54287 

NMIRES 

Reset NMIST (WRITE) 




D40F 

54287 

NMIST 

NMI Status (READ) 





D410-D4FF (54288-54527) Repeat ANTIC addresses D400 through D40F. 

CTIA CHIP 

PLAYER-MISSILE GRAPHICS CONTROL 


Horizontal Position Control (WRITE) 


D000 

53248 

H POS PO 

Horizontal Position Player 0 

D001 

53249 

HPOSPI 

Horizontal position Player 1 

D002 

53250 

HPOSP2 

Horizontal position Player 2 

D003 

53251 

HPOSP3 

Horizontal position Player 3 

D004 

53252 

HPOSMO 

Horizontal position Missile 0 

D005 

53253 

HPOSM1 

Horizontal position Missile 1 

D006 

53254 

HPOSM2 

Horizontal position Missile 2 

D007 

53255 

HPOSM3 

Horizontal position Missile 3 
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Collision Control (READ) 


D000 

53248 

MOPF 

D001 

53249 

Ml PF 

D002 

53250 

M2PF 

D003 

53251 

M3PF 

D004 

53252 

POPF 

D005 

53253 

PI PF 

D006 

53254 

P2PF 

D007 

53255 

P3PF 

D008 

53256 

MOPF 

D009 

53257 

Ml PF 

DOOA 

53258 

M2PF 

DOOB 

53259 

M3PF 

DOOC 

53260 

POPF 

DOOD 

53261 

PIPE 

DOOE 

53262 

P2PF 

DOOF 

53263 

P3PF 

Collision Clear 

(WRITE) 

D01E 

53278 

HITCl 


Size Control (WRITE) 


D008 

53256 

SIZEPO 

D009 

53257 

SIZEP1 

DOOA 

53258 

SIZEP2 

DOOB 

53259 

SIZEP3 

DOOC 

53260 

SIZEM 


Graphics Registers (WRITE) 


DOOD 

53261 

GRAFPO 

DOOE 

53262 

GRAFP1 

DOOF 

53263 

GRAFP2 

D010 

53264 

GRAFP3 

D011 

53265 

GRAFM 


Missile 0 to playfield 
Missile 1 to playfield 
Missile 2 to playfield 
Missile 3 to playfield 
Player 0 to playfield 
Player 1 to playfield 
Player 2 to playfield 
Player 3 to playfield 
Missile 0 to player 
Missile 1 to player 
Missile 2 to player 
Missile 3 to player 
Player 0 to player 
Player 1 to player 
Player 2 to player 
Player 3 to player 


Collision clear 


= quadruple size. 

Size of Player 0 
Size of Player 1 
Size of Player 2 
Size of Player 3 
Sizes of all missiles 


Graphics for Player 0 
Graphics for Player 1 
Graphics for Player 2 
Graphics for Player 3 
Graphics for all missiles 


Note: 0 = normal, 1 = double, 3 
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Joystick Controller Triggers (READ) 


D010 

53264 

TRIGO 

Read Joystick 0 trigger 

284 

644 

STRIGO 

D011 

53265 

TRIG1 

Read Joystick 1 trigger 

285 

645 

STRIG1 

D012 

53266 

TRIG2 

Read Joystick 2 trigger 

286 

646 

STRIG2 

D013 

53267 

TRIC3 

Read Joystick 3 trigger 

287 

647 

STRIG3 


Color-Luminance Control (WRITE) 

D012 53266 COLPMO 

Color-Ium. 

Player-Missile 0 

2 CO 

704 

COLRO 

D013 

53267 

COLPM1 

Color-Ium. 

Player-Missile 1 

2 CI 

705 

PCOLR1 

D014 

53268 

COLPM2 

Color-Ium. 

Player-Missile 2 

2C2 

706 

PCOLR2 

D015 

53269 

COLPM3 

Color-Ium. 

Player-Missile 3 

2C3 

707 

PCOLR3 

D016 

53270 

COLPFO 

Color-Ium. 

Playfield 0 

2C4 

708 

COLORO 

D017 

53271 

COLPF1 

Color-Ium. 

Playfield 1 

2C5 

709 

COLOR1 

D018 

53272 

COLPF2 

Color-Ium. 

Playfield 2 

2C6 

710 

COLOR2 

D019 

53273 

COLPF3 

Color-Ium. 

Playfield 3 

2C7 

711 

COLOR3 

D01A 

53274 

COLESK 

Color-Ium. 

background 

2C8 

712 

COLOR4 


Priority Control (WRITE) 

D01B 53275 PRIOR 

Priority selection 

26F 

623 

GPRIOR 

Graphics Control (WRITE) 

D01D 53277 GRACTL 

Graphics control 





MISCELLANEOUS I/O FUNCTIONS 

PAL/NTSC Systems 

D014 53268 PAL Read PAL/NTSC bits 


Console Switches (set to 8 during VBLANK) 


D01F 53279 CONSOL 
D01F 53279 CONSOL 


Write console switch port 
Read console switch port 
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POKEY CHIP 


Audio (WRITE) 


D200 

53760 

AUDF1 

Audio Channel 1 frequency 




D201 

53761 

AUDC1 

Audio Channel 1 control 




D202 

53762 

AUDF2 

Audio Channel 2 frequency 




D203 

53763 

AUDC2 

Audio Channel 2 control 




D204 

53764 

AUDF3 

Audio Channel 3 frequency 




D205 

53765 

AUDC3 

Audio Channel 3 control 




D206 

53765 

AUDF4 

Audio Channel 4 frequency 




D207 

53767 

AUDC4 

Audio Channel 4 control 




D208 

53768 

AUDCTL 

Audio control 




Start Timer (WRITE) 





D209 

53769 

STIMER 

Resets audio-frequency 
dividers to AUDF values 




Pot Scan (Paddle Controllers) 





D200 

53760 

POT 0 

Read Pot 0 

270 

624 

PADDL0 

D201 

53761 

POT 1 

Read Pot 1 

271 

625 

PADDL1 

D202 

53762 

POT 2 

Read Pot 2 

272 

626 

PADDL2 

D203 

53763 

POT 3 

Read Pot 3 

273 

627 

PADDL3 

D204 

53764 

POT 4 

Read Pot 4 

274 

628 

PADDL4 

D205 

53765 

POT 5 

Read Pot 5 

275 

629 

PADDL5 

D206 

53766 

POT 6 

Read Pot 6 

276 

630 

PADDL6 

D207 

53767 

POT 7 

Read Pot 7 

277 

631 

PADDL7 

D208 

53768 

ALLPOT 

Read 8-1 ine pot-port state 




D20B 

53771 

POTGO 

Start pot scan sequence 
(written during VBLANK) 




Keyboard Scan and Control (READ) 





D209 

53769 

KBCODE 

Keyboard code 

2 FC 

764 

CH 


Random Number Generator (READ) 

D20A 53770 RANDOM Random number generator 
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Serial Port 


D20A 

53770 

SKRES 

SKSTAT reset (WRITE) 


D20D 

53773 

SERIN 

Serial port input (READ) 


D20D 

53773 

SEROUT 

Serial port output (WRITE) 


D20F 

53775 

SKCTLS 

Serial Port 4-keyboard 
control (WRITE) 

232 562 SSKCTL 

D20F 

53775 

SKSTAT 

Serial Port 4-keyboard 

Status register (READ) 



IRQ Interrupt 




D20E 

532774 

IRQEN 

IRQ interrupt enable (WRITE) 

10 16 POKMSK 

D20E 

532775 

IRQST 

IRQ interrupt Status (READ) 



D210-D2FF (53776-54015) Repeat D200-D20F (53760-53775) 


PIA CHIP 


Joystick Read/Write Registers 


D300 

54016 

PORTA 

Writes or reads data from 

278 

632 

STICK0 




Controller Jacks 1 and 2 
if bit 2 of PACTL = 1. 

Writes to direction control register if 
bit 2 of PACTL = 0. 

279 

633 

STICK1 

D301 

54017 

PORTB 

Writes or reads data from 

27 A 

634 

STICK2 




Controller Jacks 3 and 4 
if bit 2 of PBCTL = 1. 

Writes to direction 
control register if 
bit 2 of PBCTL = 0. 

27B 

635 

STICK3 

D302 

54018 

PACTL 

Port A control (set to $3C 
by IRQ code). 




D303 

54019 

PBCTL 

Port B control (set to $3C 
by IRQ code). 





D304-D3FF (54020-54271) Repeat D300-D303 (54016-54019) 
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APPENDIX F 


PROGRAM CONVERSIONS 


COPYRIGHT NOTICE 

Computer programs are protected in general by the Copyright Law. While the 
Copyright Law expressly permits the owner of the Copyright for a Computer program to 
adapt the program as necessary for utilization on a machine, such adaptation or 
translation is otherwise generally prohibited. ATARI recommends that you only con- 
vert programs purchased from the Copyright owner or in accordance with a Software 
license. 


CONVERTING 
PROGRAMS TO 
ATARI 

MICROSOFT 

BASIC 


The COMMODORE PET*® BASIC, APPLE**® APPLESOFT**® BASIC, and RADIO 
SHACK***® LEVEL II BASIC were all written by Microsoft. The Overall approach and 
syntax of these BASIC languages has been kept compatible whenever possible to allow 
both programs and programmers to easily move from machine to machine. This ap- 
pendix reviews the differences and indicates how to work around them when Convert¬ 
ing to ATARI Microsoft BASIC. 


Microsoft divided its original BASIC into several different levels: 4K, 8K, Extended, and 
Full. Each successive level was a superset of the previous level and required more 
memory. When a manufacturer requested BASIC, the specific level to Start from was 
determined by the memory constraints of the target machine. One source of incom- 
patibility is due to starting at different levels. PET BASIC and APPLE APPLESOFT 
BASIC are based on the 8K level. RADIO SHACK LEVEL II and ATARI Microsoft 
BASIC are based on the full language level. Fortunately, this makes conversion into 
ATARI Microsoft BASIC easy. The key language differences between 8K and Full 
BASIC are the following: 


• DATA TYPES: In 8K BASIC, double precision is not supported. Only 9 digits of 
accuracy are available. Integers can be used but they are converted to single 
precision before any arithmetic is done, so their only advantage is small storage 
requirements — not speed. 

• PRINT USINC is not available, so the user has to format his own numbers. 

• The advanced Statements: IF...THEN...ELSE, DEFINT, DEFSNC, DEFDBL, 
DEFSTR, TRON, TROFF, RESUME, and LINE INPUT are not supported. 

• The functions, INSTR and STRINGS, are not supported. 

• Arrays can only be single dimensioned. 

• User-defined functions can only have one argument. 

By far the most difficult areas for conversion are machine-dependent features such as 
graphics and machine language use. In all programming it is important to isolate the 
uses of the features and document the assumption made about the machine. 

*PET is a registered trademark of Commodore Business Machines, Inc. 

"APPLE and APPLESOFT are registered trademarks of APPLE COMPUTER. 

***RADIO SHACK is a registered trademark of TANDY CORPORATION. 
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APPENDIX G 


CONVERSION FROM COMMODORE (PET) 

BASIC VERSION 4.0 


Most of the difficulty in converting from Commodore (PET) BASIC (used on Com- 
modore PET Computers) comes from specific hardware features rather than the BASIC 
language since it is a strict implementation of the 8K level. Some of the conversion 
Problems are: 

• The Commodore PET character set has been extended to 256 characters. These 
characters are block graphics characters. In Order to emulate this feature of the 
Commodore PET, an ATARI Computer user should set up a RAM-based 
character set. 

• Commodore PET BASIC has built-in constants as follows: Tl$ (TIMES for ATARI 
Computers) and TI (TIME for ATARI Computers), ST for the STATUS of the last 
I/O Operation and a pi symbol for the constant pi. 

• Commodore PET I/O is done with special Statements that control its IEEE bus. 
The arguments to OPEN are completely different from other machines and 
must be completely changed. The exact format of sending the characters is 
done by specifying a channel numberwith PRINT and INPUT Statements, which 
is the same as ATARI Microsoft BASIC, so only the OPEN and control 
Statements need to be reprogrammed. 

• The display size of the Commodore PET is 40 by 25. If menus are designed for 
this layout, they will need to be reprogrammed. 

• PEEKs and POKEs are always very machine dependent. Commodore PET pro- 
grams often use PEEK and POKE to control Cursor positioning because there is 
no direct way to change the Cursor Position. Each PEEK and POKE must be ex- 
amined and reprogrammed. 

• Commodore PET programs often embed Cursor control characters in literal text 
strings. The ATARI Microsoft BASIC also supports this feature but the character 
codes are different and must be changed. 

• The Commodore PET calls CLEAR, CLR. 

• Any use of machine language through the Commodore PET EXEC Statement will 
have to be carefully examined because although the microprocessor is the 
same, the layout of memory and the way of passing arguments to BASIC and 
receiving them from BASIC are quite different. 

• Since the Commodore PET does not Support sound or true graphics there is no 
conversion problem in these areas. 

• RND is different. RND with a positive argument (generally 1) returns a number 
between 0 and 1. 

Overall, if a special character set is set up identical to the Commodore PET's, it should 
be quite easy to convert programs that do not make heavy use of machine language or 
PEEK and POKE. 
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CONVERSION TO ATARI MICROSOFT BASIC 

Use the following table to convert a Software program developed under Commodore 

(PET) BASIC 4.0. 

Note: For simplicity, those universal BASIC commands such as RUN, CONT, and POKE 
have been omitted. In those cases, no conversion is necessary. 

The following table can also be used to perform diskette-based functions. Commodore 
(PET) BASIC 4.0 is a diskette-based language that must be supported by the ATARI 
ComputerDOS options. 

(Also see Appendix A.) 


COMMODORE (PET) Equivalent ATARI Computer ATARI 

COMMAND DOS OPTION Microsoft 

BASIC 

DIRECTORY A Bflgfü 

DIRECTORY-SEARCH SPEC, LIST FILE? 


COPY C fBfffni 

CÖPY—FROM.TO? 

D1:fn,D2:/n 

RENAME E IM NAME 

RENAME,GIVE OLD NAME,NEW 
D2 :o!d fn, new fn KTHIEffl 

SCRATCH Dünn KILL 

DELETE FILESPEC 
D2:/n KSSH B 
TYPE "Y" TO DELETE fn 

y spür: 

HEADER I Bgm 

WH ICH DRIVE TO FORMAT? 

1 ÜHSt 

TYPE "Y" TO FORMAT DRIVE 1 

y tmamn 

BACKUP DO TO Dl J U 

DUP DISK-SOURCE,DEST DRIVES? 

1,1 SÜSS 

TYPE "Y" IF OK TO USE PROCRAM AREA? 

Y KISBiT?» 

INSERT SOURCE DISK,TYPE RETURN 
INSERT DESTINATION DISK,TYPE RETURN 


126 Appendix C 


Keep in mind that the Commodore (PET) BASIC 4.0 is a diskette-supported language. 
Therefore, when converting to run the Commodore (PET) program on your ATARI 
Computer, you must be aware of the peripherals involved. 


DLOAD 

LOAD 

DCLOSE 

DOPEN 

DSAVE 

SAVE 


LOAD "DnTilename" 
CLOAD 

CLOSE filenumber 

OPEN filenumber 

SAVE filename 
CSAVE 


Some of the Commodore (PET) BASIC 4.0 commands cannot be easily supported. As 
an example, use the following conversion: 


APPEND# OPEN #1, "filespec" INPUT 

OPEN #2, "filespec" OUTPUT 
LINE INPUT#1, A$ 

PRINT #2, A$ 

CLOSE #1 
KILL ''filename'' 

INPUT "filename"; N$ 

LINE INPUT " ";A$ 

LINE INPUT " ";B$ 

PRINT#2, N$ 

PRINT#2, A$ 

PRINT#2, B$ 

CLOSE 

NAME "filename2" AS "filename" 


Check the logical flow of the Software that you wish to convert to determine the direc- 
tion of these commands. You will have to program around their use, depending upon 
the results you wish to accomplish with your Software application. 
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APPENDIX H 


CONVERTING RADIO SHACK 
TRS-80 PROGRAMS TO 
ATARI MICROSOFT BASIC 


Radio Shack BASIC is based on Full Microsoft BASIC, so converted programs will 
make much better use of the features of ATARI Microsoft BASIC than APPLE or Com- 
modore PET programs. ATARI Microsoft BASIC does have some additional features, 
such as COMMON, because it was written later and because the memory limitation 
for storing BASIC itself is not as restrictive on the ATARI Computer as it is on the Radio 
Shack Computer. The term Radio Shack BASIC refers to the BASIC built into the 
Model I and Model III Computers, and called "Level II" BASIC. The BASIC on the 
Model II is very similar, but it is not specifically covered here. 

• The Radio Shack display size poses the greatest problem in Converting TRS-80 
BASIC programs, because it is 16 by 64. Programs that use the full 64 characters 
for tables or menus will need to be changed. 

• Radio Shack Supports a form of graphics that allow black and white displays of 
128 by 48 pixels intermixed with characters. The only Statements for manipula- 
tion of the graphics are: CLS (clear screen), SET (turn a point on), RESET (turn a 
point off), and POINT (test the value of a point on the screen). 

• Radio Shack does not störe the up-arrow character in the Standard ASCII Posi¬ 
tion, so it has to be translated when moving programs onto the ATARI Com¬ 
puter. 

• Radio Shack PRINTER I/O is done with LPRINT and LLIST without opening a 
device. Radio Shack cassette I/O is done with PRINT or INPUT to channels 1 
and 2 (two drives can be supported). The format of files on cassette is complete- 
ly different. 

• Calls to machine language are done with USR. Because Radio Shack Computers 
use the Z-80 processor instead of the 6502, machine language routines will have 
to be completely rewritten. 

• PEEKs and POKEs cannot be directly converted. PEEK and POKE are not heavi- 
ly used on the Radio Shack Computers. 

• The Cursor positioning syntax is an @ after PRINT in Radio Shack BASIC and 
"AT" in ATARI Microsoft BASIC. 

• The error Codes returned by ERR are completely different. 
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TRS-80 


ATARI 


DEFINITION 


AUTO mm-nn 

AUTO mm,nn 

Generates line numbers automati¬ 
cally. 

CDBL(exp) 

— 

Returns double-precision represen- 
tation of expression. 

CINT(exp) 

— 

Returns largest integer not greater 
than the expression. 

CLOAD 

CLOAD 

LOAD"C." 

Loads a BASIC program from 
tape. 

CLOAD? 

VERIFY"C:filespec" 

Verifies BASIC program on tape to 
one in memory. 

CSNG(X) 

Automatically truncates 

Returns single-precision representa- 
tion of the expression. 

EDIT In 

AUTO line number 

Lets you edit specified line number. 
Use Cursor control keys. 

FIX(x) 

SG N(X)* 1N T(A BS(X)) 

Truncates all digits to the right of 
the decimal point. 

INPUT#-1 

OPEN#5, "C:"INPUT 
INPUT#5 

IN PUT reads data from cassette 
tape. 

LIST mm-nn 

LIST mm-nn 

Lists the program in memory onto 
the printer. 

LUST 

LIST mm-nn 

Lists program to printer. 

LPRINT 

OPEN#4, "P:" OUTPUT 
PRINT#4, "TEST" 

Prints a line on printer. 

MEM 

PRINT FRE (0) 


POINT (x,y) 

OPEN#5, "D:" INPUT or GET#iocb, AT(s,b) 

INPUT#5, AT(sector,byte) or PUT#iocb, AT(s,b) 

PRINT @ n, list 

PRINT#6, AT(x,y);list 


PRINT 

CLOAD 

Writes data to cassette. 

RANDOM 

RANDOMIZE 


SYSTEM 

DOS 
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APPENDIX I 


CONVERTING APPLESOFT PROGRAMS 
TO ATARI MICROSOFT BASIC 


Applesoft started from exactly the same BASIC source as PET BASIC, so once again 
there are very few pure language issues in converting programs to ATARI Microsoft 
BASIC. 

• Apple added two language features to Applesoft to enhance compatibility with 
their integer BASIC. They are: ONERR for error trapping and POP for eliminating 
GOSUB entries. ONERR can be easily converted to ON ERROR in ATARI 
Microsoft BASIC. POP has no equivalent since it allows a very unstructured 
form of programming where subroutines aren't really subroutines. To convert, 
add a flag, change the POP to set the flag, RETURN, and then have a Statement 
at the RETURN point check the flag and clear it and branch if it is set. 

• The Apple default display size is different from the ATARI display (actual screen 
size is the same). Menus and tables laid out to use the full display will have to be 
edited. 

• The Apple disk and peripheral I/O scheme is unique. Prints to specific channels 
are used to activate plug-in peripheral cards. The prints for the cards all have to 
be reprogrammed. 

• The most difficult conversion task is changing the graphics and sound 
Statements. The overall Apple high-resolution display size is 280 by 192. The co- 
lor control is fairly unusual because each pixel cannot independently take on all 
color values. The sound port is a single bit. 

• A variety of CALL Statements are used in Applesoft to trigger machine-specific 
features. Use of PEEK and POKE is much rarer but also must be changed. 

• Use of machine language generally will depend on the exact memory layout of 
the Apple Computer. Since the microprocessor is the same, machine language 
can be converted when the source is available except for references to the Ap¬ 
ple Operating System. 

• RND is different. Apple RND with a positive argument (generally 1) returns a 
number between 0 and 1. 
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The following list of commands, Statements, and functions illustrates how to convert 
Applesoft programs to ATARI Microsoft. 


APPLESOFT 

ATARI 

CALL 

USR (addr.) 

Ctrl C 


DEF FN name{x)= 

DEF name(x) = 

HFIN 

PLOT x,y To x,y 

HOME 

CLS 

HPEOT 

PLOT 

HTAB 

PRINT AT(x,y) 

INVERSE 

i« 

NORMAL 

Hgg «4 

LOAD 

LOAD "D:" 

NOTRACE 

TROFF 

ONERR GOTO n 

ON ERROR GOTO 

PDL 

PEEK(address) 

POP 

add flag 
check flag 

RECALL 

OPEN#n, "C:" OUTPUT 

SAVE 

SAVE "D 

TEXT 

GRAPHICS 0 

TRACE 

TRON 

VLIN 

PLOT x,y TO x,y 

VT AB 

PRINT AT(x,y) 
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APPENDIX J 


CONVERTING ATARI 8K BASIC 
TO ATARI MICROSOFT BASIC 


ATARI Microsoft BASIC has improved graphics capabilities. You should consider 
rewriting graphics sections to take advantage of player-missile graphics. The SET- 
COLOR registers have been changed so that registers 0,1, 2, and 3 now refer to player- 
missiles. What was SETCOLOR 0,cc, and 11 is now SETCOLOR 4,cc, and 11. SET- 
COLOR numbers have changed so that what was 0,1,2, 3, and 4 for the register assign¬ 
ment is now 4, 5, 6, 7, and 8. Other graphics changes include a FILL instruction and a 
"chained" PLOT that replaces DRAWTO. 

Microsoft has improved string-handling capabilities. If your initial program occupies 
too much RAM you might consider compacting it by rewriting it in Microsoft. 

The are minor differences in the RND() and other instructions when converting to 
ATARI Microsoft BASIC. The RNDQ can be made to work identically to the 8K BASIC's 
if you include a RANDOMIZE Statement as part of your program. Programs that you 
have listed in 8K BASIC onto diskette can be loaded with ATARI Microsoft BASIC, and 
with a few changes should run. 


ATARI 8K ATARI MICROSOFT 

BASIC BASIC COMMENTS 


ADR(s$) 

VARPTR(s$) 

CLR 

CLEAR 

DEC 

— 

DRAWTO 

PLOT x,y TO x,y 

LIST mm,nn 

LIST mm-nn 

LOCATE x,y,var 

var= SCRN$(x,y) 

LPRINT 

OPEN#7, OUTPUT 

PRINT#7, 

OPEN#iocb, 
aexpl ,aexp2, 
filespec 
filespec 
filespec 

OPEN#iocb, 
filespec INPUT 

POINT#iocb 
sector, byte 

INPUT#iocb, 

AT (sector, byte) 
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ATARI 8K 
BASIC 


ATARI MICROSOFT 

BASIC COMMENTS 


POP 


Use the USR function to call a machine- 
language routine. POP stack in 6502 
code. 

POSITION x,y 

PRINT|#6,| AT(x,y) 


SOUND voice, 
pitch,noise,vol. 

SOUND voice, 
pitch,noise,vol., 
duration 

The duration is a new Option. Dura¬ 
tion is given in 1/60 of a second called 
jiffies. Thus, SOUND will work the same 
as when converting programs to 
Microsoft BASIC. 

TRAP exp 

ON ERROR exp 


USR(addrJist) 

USR(addr,pointerJ 

You pass only one argument to the 
ATARI Microsoft BASIC rather than an 
argument list. 

XIO 

FILL x,y TO x,y 

Microsoft's FILL plots points from x,y 
TO x,y. It scans to the right as it fills the 
area from x,y TO x,y. The sweep 
rightward stops and a new filling scan 
begins when a solid plotted line is met. 


For other XIO commands, see Appendix N. 


PADDLE, PTRIC, STICK, STRIG are done with PEEKs and POKEs in ATARI Microsoft. 
See the Section 15, "Game Controllers," for detailed description. 
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APPENDIX K 


ATASCII CHARACTER SET 


DECIMAL CODE HEXADECIMAL CODE 


CODE CHARACTER 


0 

0 

□ 

1 

1 

13 

2 

2 

n 

3 

3 

□ 

4 

4 

□ 

5 

5 

□ 

6 

6 

Q 

7 

7 

0 

8 

8 

E 

9 

9 

D 

10 

A 

H 

11 

B 

B 

12 

C 

B 

13 

D 

H 

14 

E 

B 

15 

F 

B 

16 

10 

□ 

17 

11 

□ 

18 

12 

□ 

19 

13 

□ 

20 

14 

□ 

21 

15 

□ 

22 

16 

11 

23 

17 

□ 

24 

18 

□ 

25 

19 

□ 

26 

1A 

□ 
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DECIMAL CODE 


HEXADECIMAL CODE 


27 

1 B 

28 

IC 

29 

ID 

30 

IE 

31 

1F 

32 

20 

33 

21 

34 

22 

35 

23 

36 

24 

37 

25 

38 

26 

39 

27 

40 

28 

41 

29 

42 

2A 

43 

2B 

44 

2C 

45 

2D 

46 

2E 

47 

2F 

48 

30 

49 

31 

50 

32 

51 

33 

52 

34 

53 

35 

54 

36 

55 

37 

56 

38 

57 

39 

58 

3A 

59 

3B 

60 

3C 


CODE CHARACTER 
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DECIMAL CODE 

HEXADECIMAL CODE 

CODE CHARACTER 

61 

3D 

B 

62 

3E 

B 

63 

3F 

Ol 

64 

40 

B 

65 

41 

D 

66 

42 

□ 

67 

43 

□ 

68 

44 

Bl 

69 

45 

B 

70 

46 

D 

71 

47 

B 

72 

48 

D 

73 

49 

B 

74 

4A 

B 

75 

4B 

D 

76 

4C 

fl 

77 

4D 

D 

78 

4E 

B 

79 

4F 

□ 

80 

50 

B 

81 

51 

■ 

82 

52 

B 

83 

53 

B 

84 

54 

B 

85 

55 

B 

86 

56 

B 

87 

57 

fl 

88 

58 

B 

89 

59 

fl 

90 

5A 

B 

91 

5B 

fl 

92 

5C 

B 

93 

5D 

B 

94 

5E 

Bl 
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DECIMAL CODE 


CODE CHARACTER 


HEXADECIMAL CODE 


95 

5F 

B 

96 

60 

D 

97 

61 

■ 

98 

62 

□ 

99 

63 

B 

100 

64 

□ 

101 

65 

D 

102 

66 

B 

103 

67 

B 

104 

68 

B 

105 

69 

B 

106 

6A 

B 

107 

6B 

B 

108 

6C 

B 

109 

6D 

B 

110 

6E 

B 

111 

6F 

B 

112 

70 

B 

113 

71 

B 

114 

72 

B 

115 

73 

B 

116 

74 

B 

117 

75 

B 

118 

76 

B 

119 

77 

D 

120 

78 

B 

121 

79 

B 

122 

7A 

B 

123 

7B 

□ 

124 

7C 

D 

125 

7D 

B 

126 

7E 

B 

127 

7F 

D 
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6£L X xipudddy 


□ 

E] 

□ 

0 

0 

0 

H 

m 

s 

a 

□ 

s 

s 

a 

b 

0 

s 

Q 

□ 

b 

q 

□ 

0 

□ 

E 

s 

0 

e 

E 

e 

E 

0 

0 

N313VNVH3 3003 


ov 

d6 

36 

06 

36 

96 

V6 

66 

86 

Z6 

96 

86 

H 

£6 

36 

16 

06 

38 

38 

08 

38 

98 

V8 

68 

88 

Z8 

98 

88 

178 

£8 

ZS 

18 

08 

3003 1VWI33QVX3H 


09 L 
68 L 
88 L 
ZS L 
98 t 

sei 

HL 
£SL 
3SL 
LS U 
osi 
6n 
8H 
Zl7 L 
9H 
SH 
HL 
£H 
3t 7 L 
LH 
OH 
6£L 
8£L 
Z£L 
9£L 
8£L 
HL 
££L 
39 L 

ia 
oeu 
611 
83 L 

3003 1VWI330 



CODE CHARACTER 


DECIMAL CODE HEXADECIMAL CODE 


161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 


AI 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

AA 

AB 

AC 

AD 

AE 

AF 

BO 

Bl 

B2 

B3 

B4 

B5 

B6 

B7 

B8 

B9 

BA 

BB 

BC 

BD 

BE 

BF 

CO 

CI 

C2 


□ 

□ 

□ 

■ 

0 

0 

0 

0 

0 

0 

0 

0 

B 

0 

0 


0 

0 

0 

0 

0 

0 

0 

■ 

0 

0 

0 

0 

0 

0 

0 

■ 

0 
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DECIMAL CODE 


HEXADECIMAL CODE 


CODE CHARACTER 


195 

196 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 

207 

208 

209 

210 
211 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 


C3 

C4 

C5 

C6 

C7 

C8 

C9 

CA 

CB 

CC 

CD 

CE 

CF 

DO 

Dl 

D2 

D3 

D4 

D5 

D6 

D7 

D8 

D9 

DA 

DB 

DC 

DD 

DE 

DF 

E0 

El 

E2 

E3 

E4 
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DECIMAL CODE 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 

251 

252 

253 

254 

255 


HEXADECIMAL CODE 

E5 

E6 

E7 

E8 

E9 

EA 

EB 

EC 

ED 

EE 

EF 

FO 

Fl 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

FA 

FB 

FC 

FD 

FE 

FF 


CODE CHARACTER 
0 
□ 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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APPENDIX L 


RESERVED 

WORD 

ABS 

AFTER 

AND 

ASC 

AT 

ATN 

AUTO 

BASE 

CHR 

CHR$ 


ALPHABETICAL DIRECTORY 
OF BASIC RESERVED WORDS 


BRIEF SUMMARY 
OF BASIC STATEMENT 

Function returns absolute value (unsigned) of the variable 
or expression. 

Example: Y=ABS(A+B) 

Causes the placement of an entry on a time-interrupt list. 
The elapsed time to be associated with time interrupt is 
specified by the numeric expression in units of jiffies (1/60 
of a second). 

Example: AFTER (180) GOTO 1000 

Logical operator: Expression is true only if both subex- 
pressions joined by AND are true. 

Example: IF A = 10 AND B=30 THEN END 

String function returns the numeric ATASCII value of a 
single String character. 

Example: PRINT ASC(A$) 

Use to position disk or screen output via PRINT State¬ 
ment. 

Example: PRINT AT(S,B);"START HERE" 

Function returns the arctangent of a number or expression 
in radians. 

Example: PRINT ATN(A) 

A command generating line numbers automatically. 
Example: AUTO 100,50 

Use with OPTION Statement to set minimum value for ar- 
ray subscripts. 

Example: OPTION BASE 1 

Use with OPTION Statement to allocate RAM for alter- 
nate character sets, where: CHR1 = 1024 bytes are 
allocated (128 characters), CHR2 = 512 bytes are 
allocated (64 characters), CHR0 — free the allocated 
RAM 

Example: OPTION CHR1 

String function returns a single string character equivalent 
to a numeric value between 0 and 255 in ATASCII code. 
Example: PRINT CHR$(48) 
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CLEAR 


Use to set all Strings to null and set all variables to zero. 

Example: CLEAR 


CLEAR STACK 

CLOAD 

CLOSE 

CLS 

COLOR 

COMMON 

CONT 

COS 

CSAVE 

DATA 

DEF 

DEL 

DIM 


Resets all entries on the time stack to zero. 

Example: CLEAR STACK 

Use to put programs on cassette tape into Computer 
memory. 

Example: CLOAD 

I/O Statement used to close a file at the conclusion of I/O 
operations. 

Example: CLOSE #6 

Erases the text portion of the screen and sets the 
background color register to the indicated value, if pre¬ 
sent. 

Example: CLS 35 

Establishes the color register or character to be produced 
by subsequent PLOT and FILL Statements. 

Example: COLOR 2 

A program Statement passing variables to a chained pro¬ 
gram. 

Example: COMMON A,B,C$ 

Continues program execution after a jg||JJ or STOP. 
Example: CONT 

Function returns the cosine of the variable or expression 
(degrees or radians). 

Example: A = COS(2.3) 

Used to put programs that are in Computer memory onto 
cassette tape. 

Example: CSAVE 

I/O Statement lists data to be used in a READ Statement. 
Example: DATA 2.3,"PLUS",4 

Statement having two applications: 

1) Define an arithmetic or string function. 

Example: DEF SQUARE (X,Y) = SQR(X*X + Y*Y) 

2) Define default variable of type INT, SNG, DBL, or 
STR. 

Example: DEFINT l-N 

Delete program lines. 

Example: DEL 20-25 

Reserves the specified amount of memory for matrix, ar- 
ray, or string array. 

Example: DIM A(3), B$(10,2,3) 


END 

EOF 

ERL 

ERR 

ERROR 

EXP 

FILL 

FOR...TO...STEP 

FRE(0) 

GET 

GOSUB 

GOTO 

GRAPHICS 

IF...THEN 

IF...THEN...ELSE 


Stop program, close all files, and return to BASIC com- 
mand level. 

Example: END 

Returns true (-1) if file is positioned at its end. 

Example: IF EOF(1)COTO 300 

Error line number. 

Example: PRINT ERL 


Error code number. 

Example: IF ERR = 62 THEN END 

Generate error of code (see table). May call user ON ER¬ 
ROR routine or force BASIC to handle error. 

Example: ERROR 17 

Function raises the constant e to the power of expression. 
Example: B=EXP(3) 

Fills in area between two plotted points with a color. 
Example: FILL 10,10 TO 20,20 

Use with NEXT Statement to repeat a sequence of pro¬ 
gram lines. The variable is incremented by the value of 
STEP. 

Example: FOR DAY —1 TO 5 STEP 2 

Gives memory free space available to programmer. 
Example: PRINT FRE(0) 

Reads a byte from an input device. 

Example: GET#1,D 

Branch to a subroutine beginning at the specified line 
number. 

Example: GOSUB 210 

Branch to a specified line number. 

Example: GOTO 90 

Establishes which of the display lists and graphics modes, 
contained in the operating System are to be used to pro- 
duce the screen display. 

Example: GRAPHICS 5 

If exp is true, the THEN clause is executed. Otherwise, the 
next Statement is executed. 

Example: IF ENDVAL>0 THEN GOTO 200 

If exp is true, the THEN clause is executed. Otherwise, the 
ELSE clause or next Statement is executed. 

Example: IF X<Y THEN Y = X ELSE Y = A 
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INKEY$ 

INPUT 

INSTR 

INT 

KILL 

LEFT$ 

LEN 

LET 

LINE INPUT 

LIST 

LOAD 

LOCK 

LOG 

MERGE 


Returns either a one-character string read from terminal 
or null string if no character pending at terminal. 
Example: A$= INKEY$ 

Read data from a device. 

Example: IN PUT #1,A,B 

Read data from the keyboard. Semicolon after INPUT 
suppresses echo of carriage return/line feed. If a prompt is 
given, it will appear as written; if not, a question mark will 
appear in its place. 

Example: INPUT "VALUES";A,B 

Returns the numeric position of the first occurrence of 
string2 in stringl scanning from position exp. 

Example: INSTR(3,X$,Y$) 

Evaluates the expression for the largest integer less than 
expression. 

Example: C=INT(X + 3) 

Delete a disk file. 

Example: KILL "DdNVEN.BAS" 

Returns leftmost length characters of the string expres¬ 
sion. 

Example: B$ = LEFT$(X$,8) 

String function returns the length of the specified string in 
bytes or characters (1 byte contains 1 character). 
Example: PRINT LEN(B$) 

Assigns a value to a specific variable name. 

Example: LET X = I + 5 

Read an entire line from the keyboard. Semicolon after 
LINE INPUT suppresses echo of carriage return/line feed. 
See IN PUT. 

Example: LINE INPUT "NAME";N$ 

Display or otherwise output the program list. 

Example: LIST 100-1000 

Load a program file. 

Example: LOAD "DTNVEN" 

Sets the file locked condition for the file named in the 
string expression. 

Example: LOCK "D1:TEST.BAS" 

Function returns the natural logarithm of a number. 
Example: D= LOG (Y-2) 

Merge program on disk with program in memory by line 

number. 

Example: MERGE "D:SUB1" 


MID$ 

MOVE 

NAME 

NEW 

NEXT 

NOT 

NOTE 

ON ERROR 

ON...GOSUB 

ON...GOTO 

OPEN 

OPTION BASE 

OPTION CHR 

OPTION PLM 


Returns characters from the middle of the string starting 
at the position specified to the end of the string or for 
length characters. 

Example: A$ = MID$(X$,5,10) 

Moves bytes of memory from one area to another so that 

the block is not changed. 

Example: MOVE 45000,50000,6 

Change the name of a disk file. 

Example: NAME "D:SUB1" AS "SUB2" 

Delete current program and variables. 

Example: NEW 

Causes a FOR/NEXT loop to terminate or continue 
depending on the particular variables or expressions. 
Example: NEXT I 

Unary operator used in logical comparisons evaluates to 
0 if expression is non-zero; evaluates toi if expression is 0. 
Example: IF A=NOT B 

Causes the current disk sector number to be stored into 
the first variable and the byte number into the second 
variable for the file associated with the IOCB#. 

Example: NOTE #1,S,B 

Enables error trap subroutine beginning at specified line. 
If line=0, disables error trapping. If line = 0 inside error 
trap routine, forces BASIC to handle error. 

Example: ON ERROR GOTO 1000 

GOSUB to Statement specified by expression. (If exp = 1, 
to 20; if exp=2, to 20; if exp=3, to 40; otherwise, error.) 
Example: ON DATE%+1 GOSUB 20,20,40 

Branch to Statement specified by exp. (If exp = 1, to 20; if 
exp = 2, to 30; if exp=2, to 40; otherwise, error.) 
Example: ON INDEX GOTO 20,30,40 

Open a device. Mode must be one ofTNPUT, OUTPUT, 
UPDATE, and APPEND. 

Example: OPEN #1, "DINVEN.DAT", OUTPUT 

Declare the minimum value for array subscripts; n is 0 
or 1. 

Example: OPTION BASE 1 

Allocates space for alternate character sets. 

Example: OPTION CHR1 

Allocates space for player-missile graphics. 

Example: OPTION PLM1 
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OPTION RESERVE 


OR 


PEEK 


PLM 


PLOT 

POKE 

PRINT 

PUT 

RANDOMIZE 

READ 

REM 

RENUM 

RESERVE 


Allocates free space for programmer's use in assembly 
language program. 

Example: OPTION RESERVE(50) 

Logical operator used between two expressions. If either 
one is true, a "1" is evaluated. A "0" results only if both 
are false. 

Example: IF A = 10 OR B=30 THEN END 

Function returns decimal form of contents of specified 
memory location. 

Example: PRINT PEEK (&2000) 

Used with OPTION Statement to allocate RAM for 
player-missile graphics, where: 

PLM1 = single-line resolution 
PLM2= double-line resolution 
PLMO— free the allocated RAM 
Example: OPTION PLM2 

Plots a single point on the screen or draws from one point 
to another. 

Example: PLOT 10,10 TO 20,20 

Insert the specified byte into the specified memory loca¬ 
tion. 

Example: POKE &2310.255 

I/O command causes output from the Computer to the 
specified output device. 

Example: PRINT USING "!";A$,B$ 

Write byte-oriented data to a data file. 

Example: PUT #3,4 

Reseed the random number generator. 

Example: RANDOMIZE 

Read the next items in the DATA list and assign to 
specified variables. 

Example: READ l,X,A$ 

Remarks. Allows comments to be inserted in the program 
without being executed by the Computer on that program 
line. Alternate forms are exclamation point (!) and 
apostrophe (')• 

Example: REM DAILY FINANCES 

Renumber program lines. 

Example: RENUM 100„100 

Used with OPTION Statement to reserve a specified 
number of bytes for the programmer's use. 

Example: OPTION RESERVE (512) 


RESTORE 

RESUME 

RETURN 

RIGHT$ 

RND 

RUN 

SAVE 

SCRN$ 

SETCOLOR 

SGN 

SIN 

SOUND 


Resets DATA pointer to allow DATA to be read more 
than once. 

Example: RESTORE 

Returns from ON ERROR or time-interrupt routine to 
statement that caused error. RESUME NEXT returns to 
the statement after error causing statement and RESUME 
line number returns to statement at line number. 
Example: RESUME 

Return from subroutine to the statement immediately 
following the one in which GOSUB appeared. 

Example: RETURN 

Returns rightmost length characters of the String expres- 
sion. 

Example: C$= RIGHT$(X$,8) 

Generates a random number. If parameter = 0, returns 
random between 0 and 1. If parameter >0, returns ran¬ 
dom number between 0 and parameter. 

Example: E = RND(10) 

Executes a program starting with the lowest line number. 
Example: RUN 

Save the program in memory with name "filename." ,A 
saves program in ASCII. ,P protects file. Also, SAVE 
"filename" LOCK encrypts the program as it writes to 
disk. 

Example: SAVE"D:PROG" 

The character or color number of the pixel at an 
x-coordinate and a y-coordinate is returned as the value 
of the function. 

Example: A=SCRN$ (23,5) 

Associates a color and luminance with a color register. 
Example: SETCOLOR 0,5,5 


1 if expression > 0 
0 if expression — 0 
-1 if expression < 0 
Example: B=SGN(X+Y) 


Function returns trigonometric sine of given value in 
degrees. 

Example: B = SIN (A) 

Statement initiates one of the sound generators. 
Example: SOUND 1,121,8,10,60 
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SPC 

Use in PRINT Statements to print spaces. 

Example: PRINT SPC(5),A$ 

SQR 

Function returns the square root of the specified value. 

Example: C = SQR(D) 

STACK 

Returns the number of entries available on time stack. 

Example: A = STACK 

STATUS 

Function accepts a single argument as either a numeric or 
string then returns Status of logical unit number or file. 
Example: ST=STATUS(2) 

STOP 

Causes execution to stop, but does not close files. 
Example: STOP 

STRS 

Function returns a character string equal to numeric 
value given. 

Example: PRINT STR$(35) 

STRINGS 

Returns a string composed of a specified number of 
replications of A$. 

Example: X$ = STRING$(100 ,"A") 


Returns a string 100 units long containing CHR$(65). 
Example: Y$ = STRING$(100,65) 

TAB 

Use in PRINT Statements to tab carriage to specified Posi¬ 
tion. 

Example: PRINT TAB(20),A$ 

TAN 

Tangent of the expression (in radians). 

Example: D = TAN(3.14) 

TIME 

Returns numeric representation of time from the real time 
clock. 

Example: ATM = TIME 

TIMES 

The time of day in a 24-hour notation is returned in the 
string. The format is FIFI:MM:SS. 

Example: TIMES = "08:55:05" 

PRINT TIMES 

TROFF 

Turn trace off. 

Example: TROFF 

TRON 

Turn trace on. 

Example: TRON 

UN LOCK 

Statement terminates the LOCK condition. 

Example: UNLOCK "Dl:DATA.OUT" 

USING 

Provides string format for printed output. 

Examples: PRINT USING "###.##";PDOLLARS 



USR 

VAL 

VARPTR 

VERIFY 

WAIT 

XOR 


Function returns results of a machine-language sub- 

routine. 

Example: X=USR(SVBV, VARPTR(ARR(0))) 

Function returns the equivalent numeric value of a string. 
Example: PRINT VAL("3.1") 

Returns address of variable or graphics area in memory, 
or zero if variable has not been assigned a value. 
Example: l = VARPTR(X) 

Compares the program in memory with the one on 
filename. If the two programs are not found to be iden- 
tical, it returns an error. 

Example: VERIFY "Dl :DATA.OUT" 

Equality comparison, pauses execution until result equals 
third parameter. 

Example: WAIT &E456,&FF,30 

Bitwise exclusive OR (integer). 

Example: IF A XOR B = 0 THEN END 
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APPENDIX M 


ERROR CODES 


CODE ERROR 

1 NEXT without FOR. NEXT was used without a matching 
FOR Statement. This error may also happen if NEXT 
variable Statements are reversed in a nested loop. 

2 Syntax. Incorrect punctuation, open parenthesis, illegal 
characters, and misspelled keywords will cause syntax 
errors. 

3 RETURN without COSUB. A RETURN Statement was 
placed betöre the matching GOSUB. 

4 Out of data. A READ or INPUT # Statement was not given 
enough data. DATA Statement may have been left out or 
all data read from a device (diskette, cassette). 

5 Function call error. Attempted to execute an Operation 
using an illegal parameter. Examples: square root of a 
negative number, or negative LOG. 

6 Overflow. A number that is too large or small has resulted 
from a mathematical Operation or keybord input. 

7 Out of memory. All available memory has been used or 
reserved. This may occur with very large matrix dimen- 
sions, nested branches such as GOTO, GOSUB, and FOR 
NEXT loops. 

8 Undefined line. An attempt was made to refer or branch 
to a nonexistent line. 

9 Subscript out of ränge. A matrix element was assigned 
beyond the dimensioned ränge. 

10 Redefinition error. Attempt to dimension a matrix that 
had already been dimensioned using the DIM Statement 
or defaults. 

11 Division by zero. Using zero in the denominator is illegal. 

12 Illegal direct The use of INPUT, GET or DEF in the direct 
mode. 

13 Type mismatch. It is illegal to assign a string variable to a 
numeric variable and vice-versa. 
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15 

Quantity too big. String variable exceeds 255 characters 
in length. 

16 

Formula too complex. A mathematical or string Operation 
was too complex. Break into shorter steps. 

17 

Can't continue. A CONT command in the direct mode 
cannot be done because program encountered an END 
Statement. 

18 

Undefined user function. The USR function cannot be 
carried out. User code has an error in logic or USR start 
points to wrang memory address. 

19 

No RESUME. End of program reached in error-trapping 
mode. 

20 

RESUME without error. RESUME encountered betöre ON 
ERROR GOTO Statement 

21 

FOR without NEXT. NEXT Statement encountered betöre 
a FOR statement. 

For an explanation of the following error codes, see ATARI Disk Operating System II 
Manual. 

128 

BREAK abort 

129 

IOCB 

130 

Nonexistent device 

131 

IOCB write only 

132 

Invalid command 

133 

Device or file not open 

134 

Bad IOCB number 

135 

IOCB read-only error 

136 

EOF 

137 

Truncated record 

138 

Device timeout 

139 

Device NAK 

140 

Serial bus 
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141 


Cursor out of ränge 


142 Serial bus data frame overrun error 

143 Serial bus data frame checksum error 


144 

145 

146 

147 
160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 


Device-done error 

Read after write-compare error 

Function not implemented 

Insufficient RAM 

Drive number error 

Too many OPEN files 

Disk full 

Unrecoverable System data I/O error 

File number mismatch 

File name error 

POINT data length error 

File locked 

Command invalid 

Directory full 

File not found 

POINT invalid 
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APPENDIX N 


USE OF THE CIO 

CALLING USR ROUTINES 


There are three, prewritten USR routines provided on the ATARI Microsoft BASIC 
diskette for your use. These routines provide a flexible way to interact with the Central 
I nput/Output (CIO) facilities of your ATARI Home Computer. These routines (or similar 
routines if you prefer to write your own) allow the BASIC program to send or retrieve 
data directly to or from an Input/Output Control Block (IOCB). The lOCB's are discuss- 
ed in detail in the ATARI Operating System Users Manual (part of ATARI Personal Com¬ 
puter System Technical Users Notes). Refer to that document for a complete descrip- 
tion of CIO capabilities. 

These routines allow the BASIC programmer to perform such tasks as retrieving a disk 
directory, formatting a diskette, or conditioning a specific IOCB and its associated 
logical unit number to interface with RS-232 devices. Following is a brief description of 
how to read these routines into your own program and how to use them. 

STEP 1. Inserting the Routines Into a BASIC Program. 

All three routines are contained in the file CIOUSR on the ATARI Microsoft BASIC 
diskette. They are in a machine-readable format, ready to be poked directly into RAM. 
To allocate RAM for this purpose, use the OPTION RESERVE n Statement where n 
should be at least 160. Get the starting address of the reserved area with the Statement 
ADDR = VARPTR(RESERVE). Then, the following code can be used to put the routines 
into the BASIC program: 

OPEN #1, "D:CIOUSR" 

INPUT FOR I = 0 TO 159 
GET #1, 

POKE ADDR + l,:NEXT I 
CLOSE #1 


STEP 2. Setting Up the Data Array 

The routines are now in the reserved area of the BASIC program. There are three 
routines called PUTIOCB, CALLCIO, and GETIOCB. PUTIOCB Starts at RAM location 
ADDR. CALLCIO Starts at ADDR + 61. GETIOCB Starts at ADDR+81. 

The GETIOCB routine retrieves the user-alterable bytes from a specified IOCB and 
puts them into an integer array of length 10. The programmer may alter any of these 
Parameters and then put the new values back into the IOCB with the PUTIOCB 
routine. When the proper parameters have been set, the use of CALLCIO will cause the 
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IOCB values to be executed by the CIO facility. The next Step is to dimension an in¬ 
teger array to use for retrieval and storage of the IOCB Parameters. This array should 
be dimensioned to 10 using a BASE Option of zero. Following is a list of the elements of 
the array and what each is used for: 


Element Number IOCB Parameter 

0 This element is the number of the IOCB to be 

used (1 to 8). 

1 COMMAND CODE 

2 STATUS — returned 

3 BUFFER ADDRESS 

4 BUFFER LENGTH 

5-10 AUX byte 1 - 6 


Each element of an integer array has two bytes of data storage, so the buffer address in 
element 3 will fit into a single integer element. 


STEP 3. Caliing the USR Routines 

A USR call is used to execute the CIOUSR routines. The GETIOCB routine will return 
to the program the current values of the specified lOCB's Parameters. After changing 
these Parameters in the array, to effect some CIO function (i.e., setting the baud rate 
on an RS-232 port), the PUTIOCB routine is called to put the desired values into the 
specified IOCB. Then the CALLCIO routine is called to execute the CIO facility. 
Following is the syntax necessary to call each of the routines: 

nvar = USR(addr,VARPTR(array(0))) 

where: 

nvar — a numeric variable which will receive the Status of the CIO function in the 
case of a CALLCIO call, otherwise it will not be specifically affected by these 
routines. 

addr — the starting address of the proper CIOUSR routine, in our current example 
these would be ADDR for PUTIOCB,ADDR +61 for CALLCIO and ADDR + 81 for 
GETIOCB. 

arrayfO) — the array will be the integer array the program uses for data retrieval and 
storage for the routines. Passing the VARPTR of element zero of this array to the 
routines teils them where to begin retrieving the data from, starting with the IOCB 
number. 
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Following is an example program to set up and use an RS-232 port for telecommunica- 
tions. Also see the "Disk Directory Program" in Appendix A for another example of the 
use of these routines. 


10 ! 

20 IROUTINE TO DEMONSTRATE 
30 ICIOUSR ROUTINES... 

40 ! 

50 IPROVIDES TELECOMMUNICATIONS 
60 IWITH RS-232 DEVICES 
70 ! 

80 DIM CIO%(10),S%(10) 

90 CIO%(0) = 2 
100 S%(0) = 5:S%(1) = &0D 
110 OPTION RESERVE 200 
120 ADDR = VARPTR(RESERVE) 

130 PUTIOCB = ADDR 

140 CALLCIO = ADDR + 61 

150 GETIOCB = ADDR + 81 

160 OPEN #1 ,"D:CIOUSR" INPUT 

170 FOR 1=9 TO 159 

180 GET #1,D:POKE ADDR + l,D 

190 NEXT I 

200 CLOSE #1 

210 OPEN #1 "K:" INPUT 

220 CIO%(0)= 2 

230 CIO%(1)=3 

240 FSPEC$ = "R:" 

250 Z = VARPTR(FSPECS) 

260 Y = VARPTR(CIO%(3)) 

270 POKE Y,PEEK(Z + 2) 

280 POKE Y + 1,PEEK(Z + 1) 

290 Y = VARPTR(S%(3)) 

300 POKE Y,PEEK(Z + 2) 

310 POKE Y + 1,PEEK(Z + 1) 

320 CIO%(5) = 13 

330 A= USR(PUTIOCB,VARPTR(CIO%(0))) 

340 A= USR(CALLCIO,VARPTR(CIO%(0))) 

350 A= USR(GETIOCB,VARPTR(CIO%(0))) 

360 CIO%(1)=40 

370 CIO%(5) = 0:CIO(6) = 0 

380 A= USR(PUTIOCB,VARPTR(CIO%(0))) 

390 A= USR(CALLCIO,VARPTR(CIO%(0))) 

400 X=USR(PUTIOCB,VARPTR(S%(0))) 

410 ! 

420 ISHOULD BE READY TO GO NOW 
430 PRINT "STARTING LOOP" 

440 ! 

450 GET #1,A:PUT #2,A:POKE 764,255 

460 X=USR(CALLCIO,VARPTR(S%(0))):IF PEEK(747)= 0 THEN 480 
470 GET #2,D:IF D < >10 THEN PRINT CHR%(D); 

480 IF PEEK(764)< > 255 THEN 450 
490 GOTO 460 
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APPENDIX 0 


ACTIONS TAXEN 
WHEN PROCRAM ENDS 


ACTIONS TAKEN 


Key Pressed 
or Statement 

Executed 

Close All Files 

Run Out 
the Stack 

Clear Sound 

STOP 

ERRORS 

oo 

NO 

NO 

YES 

Running off the last 
Statement or "END" 

YES 

YES 

YES 

After a direct mode 
Statement 

NO 

YES 

NO 

RUN 

YES 

NO 

YES 
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INDEX 


A 


ABS 55, 143 
AFTFR 35,143 

Alternate character set 103-105 

AND 16,143 

Apple 123,131-132 

Arithmetic Symbols 16 

Array 53 

ASC 60, 143 

Asterisk 44-45 

ATASCII 135-142 

AT 48,143 

ATN 56, 143 

Audio track of cassette 41 
AUTO 21,143 


B 

BASE 143 
BASIC 1 

Blanks (see Spaces) 
Brightness (see Luminance) 


c 

Central Input/Output 157-159 
Character 

assigning color to 78 
ATASCII 135-142 
set, internal 103-105, 135-142 
Sizes in text modes 65 
CHR 143 
CHR$ 60, 143 

CIO (See Central Input/Output) 
CLEAR 36, 144 
Clear screen 

deferred mode 5 
direct mode 5 
CLEAR STACK 35, 144 
CLOAD 24,144 
CLOSE 50,144 
CLS 69,144 
Colon 4 
COLOR 

assigning 78 
changing 78 
default 66, 73 
registers 78, 144 
Comma 2-3, 44 
Commands 

AUTO 21,143 
CLOAD 24, 144 
CSAVE 24, 144 


DEL 22, 144 
DOS 20 
KILL 26, 146 
LIST 20, 146 
LOAD 23, 146 
LOCK 26, 146 
MERCE 24, 146 
NAME...TO 26, 147 
NEW 19,147 
RENUM 25,148 
RUN 19,149 
SAVE 23,149 
SAVE...LOCK 23,149 
TROFF 27,150 
TRON 26,150 
UNLOCK 26,150 
VERIFY 24,151 
Commodore PET 123, 125-127 
COMMON 36, 144 
Concatenation operator 59 
Constants 9 
CONT 30,144 
Controllers, 
ga me 89-91 
joystick 84 
keyboard 89 
paddle 89-90 
COS 56,144 
CSAVE 24, 144 
Cursor control keys 6 

D 

DATA 48,144 

Decimal-to-hex example 97-98 
DEF 63,144 
Default 
colors 66 
disk drive 41 
tab settings 42-43 
Deferred mode 1 
DEFDBL 11 
DEFSNG 10 
DEFSTR 13 
DEL 22, 144 
Derived functions 107 
Devices 41 
Delete line 7 
DIM 53,144 
Direct mode 1 
Disk directory program 93 
Disk drive 

default number 41 
Disk drives (D.) 41 
Display, split-screen override 65 
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Distortion 85 

trigonometric 

Dollar sign 45 

ATN 56, 143 

Double-Iine resolution 77 

COS 56, 144 

Double Precision 

SIN 56,149 

double-precision real constants 10 

TAN 56,150 

double-precision real variables 11 
DEFDBL 11 

DOS 20 

G 

E 

Game Controllers 
keyboard 89 

Editing 5 

joystick 84, 90-91 
paddle 89-90 

Editing, screen 6-7 

CET 50, 145 

END 30,145 

GOSUB 33,145 

End of program 

GOTO 30, 145 

actions taken 161 

GRAPHICS 65,145 

EOF 51,145 

Graphics 

ERL 35,145 

modes 65, 69-71 

ERR 35, 145 

Statements 

ERROR 34,145 

CLS 69 

Error messages 153-155 

COLOR 66 

Escape key 5 

FILL 68 

Exclamation sign 46 

GRAPHICS 65, 145 

EXP 56, 145 

PLOT 68 

Explosion example 94 

SETCOLOR 67 

Exponential symbol 16, 45 

Expressions 
logical 15 

H 

numeric 15 

String 15 

Hexadecimal constants 13 

F 

Fanfare music example 94-95 

1 

IF...THEN 31,145 

FILL 68, 145 

IF...THEN...ELSE 31,145 

FOR...TO...STEP 32,145 

INKEYS 61,146 

FRE (0) 57,145 

IN PUT 47, 146 

Function 

Input/output Statements 

arithmetic 

AT 48 

ABS 55, 143 

CLOAD 24, 144 

EXP 56, 145 

CLOSE 50, 144 

INT 55, 146 

CSAVE 24, 144 

LOG 56, 146 

DATA 48, 144 

RND 55, 149 

DOS 20 

SGN 55, 149 

EOF 51,145 

SQR 55,150 

GET 50,145 

derived 107 

INPUT 47, 146 

special purpose 

LINE INPUT 47 

FRE (0) 57,145 

LOAD 23, 146 

PEEK 56,148 

NOTE 50,147 

POKE 57, 148 

OPEN 49, 147 

USR 58,151 

PRINT 41,148 

TIME 58, 150 

PRINT USING 43 

string 

PUT 50,148 

ASC 60,143 

READ 48, 148 

CHR$ 60, 143 

RESTORE 48 

INKEY$ 61,146 

SAVE 23,149 

INSTR 61,146 

SPC 43 

LEFT$ 59,146 

STATUS 50,150 

LEN 60, 146 

TAB 42,150 

RIGHTS 60, 149 

Input/Output Control Block 

SCRN$ 62, 149 

Input/output devices 

STR$ 61,150 

disk drives (D:) 41 

STRINGS (N,A$) 61,150 

keyboard (K:) 41 

STRINGS (N,M) 61,150 

Printer (P:) 41 

TIMES 62,150 

program recorder (C:) 41 

VAL 60,151 

RS-232 interface (R:) 41 


12, 157-158 


screen editor (E:) 41 

TV monitor (S:) 41 
INSTR 61,146 
INT 55,146 

Integers 

integer constants 11 
integer variables 11-12 
DEFINT 12 
Inverse key 5 

IOCB (see Input/Output Control 


J 

Joystick Controller 84 


K 

Keyboard (K:) 41 

Keyboard Controllers 89 
Keyboard Operation 5 
Keys 

special function 
ATARI 5 
BACKSPACE 6 
BREAK 5, 7 
CAPS/LOWER 5 
CLEAR 6 
DELETE 6-7 
ESCAPE 5 
INSERT 6 
RETURN 5, 41 
SYSTEM RESET 5 
TAB 6 
editing 

CONTROL 6 
SHIFT 5, 7 
Cursor control 
down arrow 6 
left arrow 6 
right arrow 6 
up arrow 6 
Keywords 2 
KILL 26,146 


L 

LEFT$ 59, 146 
LEN 60,146 
LET 29, 146 
Letters 

Capital (uppercase) 5 
lowercase 5 
LINE INPUT 47,146 
LIST 20, 146 
LOAD 23, 146 
LOCK 26, 146 
LOG 56, 146 
Logical operators 16 
Luminance 78 


M 

Mandatory # symbol 43 
MERGE 24, 146 
Memory locations 109 


Microbe Invasion example 101 
Microsoft 

conversion from Apple Applesoft 123, 
131-132 

conversion from ATARI 8K BASIC 133-134 
conversion from Commodore PET 
BASIC 123,125-127 
conversion from Radio Shack Level II 
BASIC 123,129-130 
Block) MID$ 59, 147 

Minus sign 46 
Missiles 76-77 
Modes, graphics 65, 69-71 
Modes, operating 
deferred 1 
direct 5 
Modes, text 

Override split-screen 65 
MOVE 30, 75, 147 
Music example 94 


N 

NAME...TO 26, 147 
NEW 19,147 
NEXT 32, 147 
NOT 16,147 
NOTE 50,147 

NOTE.DAT creation program 96 
Numeric expressions 15 


o 

ON ERROR 34,147 
ON...GOSUB 34, 147 
ON...GOTO 33, 147 
OPEN 48,147 
Operators 

arithmetic 16 
binary 16 
logical 16 
relational 15 
OPTION BASE 36, 147 
OPTION CHR 38,147 
OPTION PLM 38,76,147 
OPTION RESERVE 39, 148 
Output devices 41 
OR 16,148 


P 

Paddle Controllers 89-90 
Parentheses 16 
PEEK 56, 89, 148 
Percent sign 47 
Period 44 

Peripheral devices (see Input/output devices) 

Piano example 95-96 

Pitch 

definition 83, 86 
values 86 

Player-missile example 75, 81 
Player-missile graphics 
annotation 82-84 
collision control 80-81 
color control 78 
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diagonal movement 79 
horizontal movement 79 
mapping 77 

priority control 80 

RAM configuration 77 
size control 78 
vertical movement 79 
PLOT 68, 148 
Plus sign 46 
Point-plotting modes 72 
POKE 57, 148 
Pound sign 43 
Precision 

of numeric variables 9 
Precedence of operators 15-16 
PRINT41, 148 
Printer (P:) 41 

Printer listing 21,41 
PRINT USINC 43 
Program Recorder (C:) 41 

PUT 50, 148 


Q 

Question mark as prompt 42 
Quotation marks 2 


R 

RadioShack 123,129-130 
RANDOMIZE 37, 102, 148 
READ 48,148 

Relational and logical symbols 15 

Relational operators 15-16 

REM 29, 148 

RENUM 25, 148 

RESERVE 148 

Reserved Words 143-151 

RESTORE 48, 149 

RESUME 36, 149 

RETURN 33,149 

RIGHTS 60,149 

RND 55, 102, 149 

RS-232 (R:) 41,159 

RUN 19, 149 


s 

SAVE 23, 149 
SAVE...LOCK 23, 149 
Screen editor (E:) 41 

SCRN$ 62, 149 
Semicolon 3 

SETCOLOR 67, 76, 78, 149 
SCN 55, 149 
Single-line resolution 77 
Single precision 

single-precision real constants 9 
single-precision real variables 9 
DEFSNC 10 
SIN 56,149 
SOUND 

rocket example 87 
terminating 85 


Spaces 47 

SPC 43,150 

Special function keys 5 

SQR 55,150 

STACK 35,150 
Statements 
AFTER 35, 143 
CLEAR 36, 144 
CLEAR STACK 35,144 
COMMON 36, 144 
CONT 30, 144 
END 30, 145 
ERL 35, 145 
ERR 35, 145 
ERROR 34, 145 
FOR...TO...STEP 32,145 
COSUB 33,145 
GOTO 30, 145 
IF...THEN 31,145 
IF...THEN...ELSE 31,145 
LET 29,146 
MOVE 30, 147 
NEXT 32,147 
ON ERROR 34, 147 
ON...COSUB 34,147 
ON...COTO 33, 147 
OPTION BASE 36, 147 
OPTION CHR 38,147 
OPTION PLM 38, 147 
OPTION RESERVE 39, 148 
RANDOMIZE 37, 148 
REM 29,148 
RESUME 36,149 
RETURN 33, 149 
STACK 35,150 
STOP 30, 150 
SUBROUTINES 33 
VARPTR 39,151 
WAIT 31,151 
STATUS 50,150 
STOP 30,150 
STR$ 61,150 
Strings 

concatenation operator 59 
DEFSTR 13 
String constants 12 
String expressions 16 
String functions 
ASC 60, 143 
CHR$ 60, 143 
INKEYS 61,146 
INSTR 61,146 
LEFTS 59, 146 
LEN 60,146 
MIDS 59,147 
RIGHTS 60,149 
SCRNS 62, 149 
STRS 61, 150 
STRINGS (N,AS) 61,150 
STRINGS (N,M) 61,150 
TIMES 62,150 
VAL 60,151 
string variables 12 
STRINGS (N,AS) 61,150 
STRINGS (N,M) 61,150 
Subroutine 
definition 33 
COSUB 33, 145 


T 


TAB 43,150 

TAN 56,150 

Text modes 65 

TIMES 62,150 

TIME 58,150 

TROFF 27,150 

TRON 26,150 

TV monitor (S:) 41 

Typewriter graphics example 74 


u 

UNLOCK 26, 150 
User-defined function 
DEF 63, 144 
US1NG 150 
USR 58,151 


V 


VAL 60, 151 
Variables 
naming 9 

VARPTR 39,76-77,151 
VERIFY 24,151 

Vertical fine Scrolling example 98-99 
Voice 85 


w 

WAIT31. 151 
Window 

graphics 65 
text 65 


X 

X-coordinate 68 
XOR 16,151 

Y 

Y-coordinate 68 


z 

Zero 

as dummy variable 57 
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IMPORTANT WARRANTY INFORMATION 


LIMITED 90-DAY WARRANTY 
ON ATARI® COMPUTER CASSETTES, 
CARTRIDGES, OR DISKETTES 


ATARI, INC ("ATARI") warrants to the original consumer purchaser that this ATARI Computer Cassette, Cartridge, or Diskette ("Computer 
Media"), not including Computer programs, shall be free from any defects in material or workmanship for a period of 90 days from the date 
of purchase. If any such defect is discovered within the warranty period, ATARI, at its Option, will repair or replace the defective Computer 
Media. Computer Media returned for in-warranty repair/replacement must have the ATARI labef still intact, must be accompanied by proof 
of date of purchase satisfactory to ATARI, and must be delivered or mailed, postage prepaid, to: 

ATARI, INC. 

Customer Service Department 
590 Brennan Street 
San (ose, CA 95131 

This warranty shall not apply if the Computer Media (i) has been misused or shows signs of excessive wear, (ii) has been damaged by being 
used with any products not supplied by ATARI, or (iii) has been damaged by being serviced or modified by anyone other than the ATARI 
Customer Service Department. 

ANY APPLICABLE IMPLIED WARRANTIES, INCLUDING WARRANT1ES OF MERCHANTABILITY AND FITNESS FOR A PART1CULAR PUR¬ 
POSE, ARE HEREBY LIMITED TO NINETY DAYS FROM THE DATE OF PURCHASE. CONSEQUENTIAL OR INCIDENTAL DAMAGES 
RESULT1NG FROM A BREACH OF ANY APPLICABLE EXPRESS OR IMPLIED WARRANTIES ARE HEREBY EXCLUDED. 

The provisions of the foregoing warranty are valid in the United States only and are subject to the laws of the State in which the Computer 
Media is purchased. Such laws may broaden the warranty protection available to the consumer purchaser of the Computer Media. 

REPAIR SERVICE: Ifyour ATARI Computer Media requires repair other than under the90-day Limited Warranty, please contact the ATARI 
Customer Service Department for repair/replacement information. From California call (800) 662-6297, Outside California (800) 538-7037 or 
(800) 538-7602 in Hawaii or Alaska. 

IMPORTANT: If you ship your ATARI Computer Media, package it securely and ship, charges prepaid and insured, by parcel post or 
United Parcel Service. ATARI assumes no liability for losses incurred during shipment. 

DISCLAIMER OF WARRANTY ON ATARI COMPUTER PROGRAMS: 

All ATARI Computer programs are distributed on an "as is" basis without warranty of any kind. The entire risk as to the quality and perfor- 
mance of such programs is with the purchaser. Should the programs prove defective following their purchase, the purchaser and not the 
manufacturer, distributor, or retailer assumes the entire cost of all necessary servicing or repair. 

ATARI shall have no liability or responsibility to a purchaser, Customer, or any other person directly or indirectly, by Computer programs 
sold by ATARI. This includes, but is not limited to any interruption of Service, loss of business or anticipatory profits, or consequential 
damages resulting from the use or Operation of such Computer programs. 












